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CHAPTER 1 
INTRODUCTION 


1 . 1 GENERAL 

This manual describes the Table-Driven Task Initiator (TDTI) operating under 
VERSAdos or RMS68K. It describes what a TDTI system is, describes what it can 
do, and provides detailed instructions in the use of such a system. A 
comprehensive example and instructions for generating an example system using 
furnished chainfiles are included in this document. 


1.1.1 TDTI Software 

A TDTI system consists of two parts. The first part, which is supplied in the 
software package, consists of the following; 

. RMS68K kernel 

. Standard RMS68K system initializer 
. Procedure portion of the TDTI 

. Optional I/O subsystem which consists of user-selected drivers and the 
VERSAdos I/O subsystem tasks File Handling Services (FHS) and Input/ 
Output Services (lOS) (these items are not included for an RMS68K-type 
system) 

The second part of the system consists of user-written code: 

. All user-written application tasks 

. All user-written non-standard startup code and error handling logic 
. The Task Table (TT) that TDTI will process 


1.1.2 Operating Environment 

The Task Initiator is run, in association with RMS68K, on a target machine in 
an environment where application software is developed on a host machine and 
downloaded to be tested on a target machine. The host machine can be any 
M68000-family system running VERSAdos. The target machine can be any M68000- 
family system with RMS68K. 
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1.2 FUNCTIONAL DESCRIPTION 


1.2.1 Purpose 

A TDTI system is an RMS68K or VERSAdos operating system along with some user- 
written tasks and some "special" code called TDTI which is used to start the 
other tasks in the system in a controlled way. A TDTI system provides the 
following capabilities: 

a. Assists in debug effort by giving the user complete control over start- 
up processing in the system. If a system consists of several tasks, the 
user can elect to start these tasks in any order by making simple 
changes to a table. If the system consists of a number of tasks but the 
user is concerned only with a small subset, it is possible to prevent 
some tasks from starting at all by making minor table modifications. 

b. Saves time by allowing the user to make modifications to the system 
without having to initiate a SYSGEN process every time. If the user 
desires to replace a task, the module to be replaced and the SYSGENed 
table-driven system can be downloaded, the Program Counter (PC) can be 
set, and processing can continue. Thus, the user can easily replace a 
task and eliminate the need for having to re-SYSGEN. 

c. Allows the user to define code to handle errors during startup 

processing. The error handling code can be as simple as a branch-to- 

self which will "hang" the system and allow for postmortem debug 

analysis, or extremely sophisticated code which may attempt error 
recovery. 

d. Provides an easy path to ROMing the end product. The RMS68K, TDTI, and 
most VERSAdos components are directly ROMable. Once the system is 
debugged in RAM, ROMing is a trivial step. Note that the VERSAdos file 
management subsystem. Session Control, and the loader are not ROMable, 
but the I/O subsystem and drivers are. 

The user is not restricted to the predefined "standard" functions that the 
TDTI program performs. If "non-standard" processing to startup a particular 
task is desired, the user may write code to be executed in lieu of the 
"standard" processing that TDTI would normally perform for that task, while 
still using the TDTI "standard" functions for other tasks in the same system. 

TDTI performs several functions on behalf of a task during its "standard" 
processing. Some examples are: "create Task Control Block (TCB)", "task 

segment allocation", and "setting the task initial state to dormant or 
executing". All of these functions are directly accessible to user code as 
subroutines. Thus, if the user desires to write some special startup 
processing for a particular task, some of these "standard" functions may be 
found to be useful and thus less special purpose code would have to be 
written. 
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1.2.2 Operation 

A typical TDTI system can be started in one of several ways; 

a. The system can be booted into RAM from disk and given control from the 
Initial Program Loader (IPL). 

b. The system can be downloaded from a host using debug firmware commands 
and manually started, by setting the PC and the stack register A7 and 
entering the GO command. 

c. The system may be embedded; that is, it may exist entirely in ROM and be 
given control during a power-up sequence. 

When the TDTI system has control, the following functions are performed: 

a. The first process to get control is the system initializer. It is 
really an extensive initialization process that sets up the proper 
environment for RMS68K to run. Some of the functions it performs are: 

. Initializes the system vectors. 

. Initializes memory and builds free memory lists. 

. Initializes System Parameter Area (SYSPAR). 

. Initializes the Memory Management Unit (MMU) if one exists. 

. Initializes any special devices such as timers or special I/O 
devices. 

. Sets up system tables for: 

ASN Address segment numbers 

GST Global segment table 

UST User semaphore table 

lOV I/O vector map 

PAT Periodic activation table 

UDR User-defined directive table 

Most of the functions performed by the system initializer are controlled 
by parameters defined at system generation (SYSGEN) time. Do not 
confuse these functions with the startup functions performed by TDTI. 
The functions performed by the TDTI are controlled by a table that the 
user can easily modify without initiating a new SYSGEN process. For a 
complete discussion of SYSGEN-related parameters, refer to the System 
Generation Facility User’s Manual. 
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b. After the system initializer has completed its initialization, control 
is passed to the RMS68K kernel. The dispatch sequence initiated by the 
kernel is as follows: 

For an RMS68K TDTI system . The kernel will dispatch the TDTI task, as 
it is the only task that has been defined to the system. The user- 
written tasks will not be defined to the system until TDTI has executed. 

For a VERSAdos TDTI system . The kernel will dispatch the I/O subsystem 
task. Prior to termination, the I/O subsystem task will ensure that the 
TRAP #2 and #3 I/O handlers are ready for execution; then it will start 
the TDTI task, which in turn will make the user-written task known to 
the system. 

c. The function of the TDTI task is not complex. It operates on a user- 
written table that can contain any number of entries. The entries are 
processed in an order that is determined by a "priority" field that is 
part of the task entry itself. Normally an entry will contain the 
information that the TDTI needs in order to define a task to RMS68K. An 
entry such as this will be referred to as a "standard" entry and the 
processing associated with such an entry will be termed "standard" 
processing. Standard processing consists of the following: 

1. Creating a TCB. 

2. Allocating segment(s) to the task associated with the entry. 

3. Optionally starting the task. 

Most of the information in a single table entry is the information 
required to perform the above functions. Some additional information is 
required in the table, however. This additional information falls into 
the following groupings: 

1. Control -related information consisting of the following: 

. Processing priority which defines the order in which 
entries in the table are processed. 

. Links which point table entries to successive entries and 
links which point to non-standard user defined code. 

2. Debugging aids consisting of user defined "eye catchers". 

A hierarchical relationship of RMS68K, the TDTI, the TT, and the associated 
task is shown in Figure 1-1. 
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1.3 CONVENTIONS USED IN THIS MANUAL 

The following conventions are used in the command syntax, examples, and text 
in this manual: 

boldface strings A boldface string is a literal such as a command or a 
program name, and is to be typed just as it appears. 

italic strings An italic string is a "syntactic variable" and is to 
be replaced by one of a class of items it represents. 

Operator inputs are to be followed by a carriage return. The carriage return 
is shown as (CR) only if it is the only input required. 


1.4 RELATED DOCUMENTATION 

The following publications may provide additional helpful information. If not 
shipped with this product, they may be obtained from Motorola’s Literature 
Distribution Center, 616 West 24th Street, Tempe, AZ 85282; telephone (602) 
994-6561. 


MOTOROLA 

DOCUMENT TITLE PUBLICATION NUMBER 


System Generation Facility User’s Manual 

M68000 Family Real-Time Multitasking Software User’s Manual 

VERSAdos Data Management Services and Program Loader 
User’s Manual 

M68000 Family Linkage Editor User’s Manual 

M68000 16/32-Bit Microprocessor Programmer’s Reference Manual 


M68KSYSGEN 

M68KRMS68K 

RMS68KI0 

M68KLINK 

M68000UM 
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FIGURE 1-1. Hierarchical Relationships Within TDTI System 
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CHAPTER 2 
TASK TABLE 


2.1 GENERAL 

Understanding how to use the TDTI system requires a thorough understanding of 
the Task Table (TT) format. The table provides a flexible way for the user to 
control the behavior of the system at startup time. 

The TT consists of a header followed by one or more Task Table Entries (TTE). 
(See Figure 2-1.) A utility program, TTGEN, is furnished to simplify creation 
of a TT. It is described in paragraph 3. Refer also to Appendix A for a 
sample TT. 

The header has a self-relative link to the first TTE. Each TTE in turn is 
linked to the next TTE by a self-relative offset. The last TTE contains a 
self-relative offset value of zero. 


Task Table Format 


Task Table Entry Format 


j Task Table 
+--| Header Information 


+->| Task Table Entry 1 

I 

+-I 

I + - 

|-> 


+-- 

I + 

I I 

+->| Task Table Entry n 
I (Self-relative offset 
I equals zero) 

+ 



+ 


+ + 

+->| I 

I I Task Entry 1 1 

I Header Information | 

I I I 

+ - + 

> I ! 

I I Task Entry 1 I 

I I Task Control Block | 

I I Related Information | 

I I I 

+ --+ 

I I I 

I I Task Entry 1 I 

I I Segment 1 Allocation | 

I I Related Information | 

I I I 

+ + 


+ 


+-> 


+ - + 

I ! 

I Task Entry 1 I 

I Segment n Allocation j 

I Related Information | 

I I 

+ - + 


FIGURE 2-1. Task Table Entries 
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Each TTE contains information required to make the task known to the operating 
system by creating the Task Control Block (TCB), allocating the segment(s) 
required by the task, and setting the initial state of the task to dormant or 
executing. 

The TT and all of the TTEs typically would appear as a contiguous block of 
data in RAM. However, this is not a requirement since the task table is a 
linked structure. 


2.2 SELF-RELATIVE LINKS 


Any pointers or links used in the TT are "self-relative". This means that the 
link is a 4-byte field containing the PC-relative offset from the link to the 
data or code item. As an example, consider the following: 

Assume that AO contains the absolute address of a data structure ($1000) and 
the contents at offset LINK ($500) in this data structure consists of the PC- 
relative offset ($200) to data item B. Then data item B would be located at 
physical address $1700. 


One way to obtain the address of data item B in A4 would be to execute the 
following sequence of code: 


LEA LINK(A0),A4 
ADD.L (A4),A4 


AO 


-> +- 


A4 contains the address of the 
link 

A4 contains the absolute address 
of data item B which is equal to 
the sum of the absolute address 
of LINK plus the contents of 
LINK 

ABSOLUTE ADDRESS 
+ $1000 


LINK ($500) 


A4 


-> + 


Offset to data 
item B ($200) 


(Data item B) 


$1500 


$1700 
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2.3 TASK TABLE FIELD DEFINITIONS 

The following illustrations describe the field contents of the TT. Shown with 
each description is the mnemonic that provides offset identification, used by 
TDTI, associated with the field. Explanations of the fields follow the 
illustrations and have been grouped by function. The letter following each 
mnemonic identifies the functional grouping where this field is described in 
detail . 


Task Table Header 
TTSUHID (A) 
TTSEHLOS (B) 
TTSFTEOS (B) 


•f I" 

I User-generated table header identifier | 

+ h 

I Self-relative offset to error handling logic | 

■j + 

I Self-relative offset to first task entry | 

+ — + 


Task Table Entry 
TTSUTEID (A) 

1 User-generated task entry identifier 

TTSNEOS 

(D) 

1 Self-relative offset to next task table entry 

TTSUSC 

(D) 

1 Self-relative offset to non-standard code 

TTSTSKPO 

(C) 

1 Task processing order 

TTSINITS 

(G) 

1 Task initial state 

TTSTN 

(E) 

1 Taskname 

TTSTSN 

(E) 

1 Task session number 

TTSTCBDO 

(E) 

1 TCB directive options 

TTSMTN 

(E) 

1 Monitor taskname 

TTSMTSN 

(E) 

1 Monitor task session number 

TTSTIP 

(E) 

1 Task initial priority 

TTSTLP 

(E) 

1 Task limit priority 

TTSTCBTA 

(E) 

1 TCB task attributes 

TTSTEPA 

(E) 

1 Task entry point address 

TTSUGID 

(E) 

1 Task user-generated identification 

TTSNOS 

(F) 

1 Number of segments 


+ 


+ 
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Task Table Entry Segment Information 


+ - + 


TTSGSDO 

(F) 

1 Segment directive options 

1 

TTSGSSA 

(F) 

1 Segment attributes 

1 

TTSSEGNM 

(F) 

1 Segment name 

1 

+ 

TTSSEGAD 

(F) 

1 Segment address 

1 

TTSSEGSZ 

(F) 

1 Segment size in bytes 

1 





Debug Aids 





There is no function associated with these fields other than to allow 
the user to identify easily the start of the entity described. 
Typically these identifiers will be a string of up to four ASCII 
characters that would easily be recognized in a memory dump. 

TTSUHID; 4 bytes -- User header identifier 

This field is a user-generated TT header identifier, i.e. 
"!HDR". 

TTSUTEID: 4 bytes -- User task entry identifier 

This field is a user-generated task entry identifier, i.e. 
"TEOl". 


b. Header Related Fields 

TTSEHLOS; 4 bytes -- Error handling logic offset 

This field contains a self-relative offset to the user- 
written error handling logic to be executed if the TDTI 
task encounters an error while processing the TT. A simple 
error handling routine that would "hang" the system and 
allow postmortem debug is a Branch-to-Sel f instruction. 
Upon entering the error handling logic register, A4 will 
point to the TTE being processed, A5 will point to the TT 
header, and A7 will point to an Error Index Value. (Refer 
to Appendix E.) 

The user may elect to bypass the error handling capability 
in one of two ways: 

1. By placing a value of zero in this field. 
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2. By setting bit 0 in this field, giving an odd self- 
relative offset. 


If either of the above is done and an error is encountered 
while processing a TTE, processing on that entry will 
terminate and execution will commence with the next TTE. 
Bit 0 was selected because the user could easily set and 
reset this bit without destroying the even value of the 
self-relative offset. 

If the user elects to return from the error handling logic, 
via an RTS instruction, he must preserve the stack pointer. 
Preservation of all other registers will be done by the 
TDTI task. Upon return, processing will commence with the 
next TTE. 


2 


TTSFTEOS: 4 bytes -- First task entry offset 

This field contains the self-relative offset to the first 
TTE in the TT. A value of zero implies that there are no 
TTEs. 


c. Priority Processing Order Value 

TTSTSKPO: 2 bytes -- Task priority processing order value 

This field contains the task priority processing order 
value. The execution order is from low to high. Assume 
the TT has four TTEs as follows: 


TT PROCESSING ORDER 

ENTRY VALUE 

1 31 

2 10 

3 17 

4 35 

The TTE processing order would be TTE2, TTE3, TTEl, TTE4. 

If multiple TTEs with the same processing order value 
exist, the TTEs will be processed sequentially from the 
first entry to the last entry. 

Assume a TT had four TTEs as follows: 


TT 

ENTRY 

1 

2 

3 

4 


PROCESSING ORDER 
VALUE 
31 
05 
17 
05 
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The TTE processing order would be TTE2, TTE4, TTE3, TTEl. 

The user can bypass processing of a TTE by setting bit 15 
in this field. Bit 15 was selected because the processing 
order value will never be negative and the user can easily 
set and reset this bit without destroying the processing 
order value. 

The user may elect to disregard this field entirely, 

leaving a value of zero in each TTE, in which case the 
entries will be processed in the exact order as they are 
defined in the table. 

d. Links Not Associated with the TT Header 

TTSNEOS: 4 bytes -- Self-relative offset to the next table entry 

This field contains the self-relative offset to the next 
TTE in the TT. A value of zero implies there are no more 
TTEs in the TT. 

TTSUSC: 4 bytes -- Self-relative offset to non-standard user code 

The user can elect to have TDTI perform the "standard" 

processing functions for a particular TTE in the TT, or he 
can elect to assume these responsibilities with his own 
code. Typically this would be done if a task required 
unique or additional functions which are not a part of 
TDTI’s "standard"’ processing. If the user elects to 
assume this responsibility, this field contains the self- 
relative offset to the non-standard user code to be 
processed for this task. 

If non-standard code is to be executed, a Jump-to- 
Subroutine (JSR) call will be made to the non-standard 
code. The user is responsible for maintaining the stack 
pointer and returning via an RTS instruction. Preservation 
of all other registers will be done by the TDTI task. On a 
call to the non-standard code, register A5 will point to 
the TT header, and register A4 will point to the TTE to be 
processed. Routines normally executed by the TDTI task 
will be accessible to the non-standard user code as 
subroutines, via a JSR. These routines include: 

. Character-fill a work area 

. Create a TCB for a task 

. Call the task table error handling logic, which 
ultimately executes the user-written error handling 
code 
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. Obtain the task identification, which is required 
usage for a realtime task 

. Allocate segments for a task 

. Start a task 

Refer to Appendix D for details regarding these sub- 
routines. 

Upon return from the non-standard user code, the TDTI task 
commences processing with the next TTE in the TT. 

Since all non-standard user-written code that is executed 
operates as a subroutine to TDTI, the user can execute any 
RMS68K directive desired. For example, it is possible that 
the user may wish to execute a delay request as a 
coordination effort before moving on to the next entry in 
the TT. 

An example of this is demonstrated with entry number 5 in 
the module 9990..TTS.SA and the corresponding user code in 
module 9990.&.TE05USC.SA. (Refer to Appendix B.) 

Note that in this example, which has non-standard user 
code, only the following fields were defined: 

TTSNEOS -- Self-relative offset to next TTE 

TTSUSC -- Self-relative offset to non-standard user 
code 

TTSTSKPO -- Task priority processing order value 

The user may elect not to execute existing non-standard 
code by setting bit zero of this field. In this case, the 
TTE will be processed as if the non-standard code did not 
exist. Bit zero was selected because the user could easily 
set and reset this bit without destroying the even value of 
the self-relative offset. 

A value of zero implies there is no non-standard user code. 
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e. Create Task Control Block Information 

This information is related to the RMS68K directive "CRTCB" found in 
the M68000 Family Real-Time Multitasking Software User’s Manual. 

TTSTN: 4 bytes -- Taskname 

This field contains the taskname. 

TTSTSN: 4 bytes -- Task session number 

This field contains the session number of the task. 

TTSTCBDO: 2 bytes -- TCB directive options 

This field contains the TCB directive options. 

TTSMTN: 4 bytes -- Monitor taskname 

This field contains the monitor taskname for this task 
entry. 

TTSMTSN: 4 bytes -- Monitor task session number 

This field contains the session number of the monitor task. 
TTSTIP: 1 byte -- Initial priority 

This field contains the task initial priority. 

TTSTLP: 1 byte -- Limit priority 

This field contains the task limit priority. 

TTSTCBTA: 2 bytes -- TCB task attribute 

This field contains the TCB task attributes. 

TTSTEPA; 4 bytes -- Entry point address 

This field contains the task entry point address. 

TTSTUGID: 2 bytes -- Task ID 

This field contains a user-generated task identification. 

f. Segment Handling Information 

TTSNOS: 2 bytes -- Number of segments 

This field contains the number of segments, range of one to 
four, which TDTI will allocate to this task. 
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The following information is related to the RMS68K directives "GTSEG", 
"DCLSHR", and "SHRSEG" found in the M68000 Family Real-Time 
Multitasking Software User’s Manual. 

The segment directive options and the segment attributes reflect a 
subset of options and attributes that have been extracted from the 
TRAP #1 calls of GTSEG, DCLSHR, and SHRSEG. This subset has been 
determined to give the maximum flexibility for the following logic 
sequence which the TDTI task processes. 

If a segment is declared shareable, an attempt will be made to grant 
shared access for the requesting task. If shared access is denied, 
TDTI will allocate the segment to itself, declare it shareable, and 
then transfer it to the target task. TDTI will perform segment 
allocation for the target task if shared access is not requested. 

The appropriate directive options and segment attributes will be 
selected for the TRAP call being initiated. 

The description of the last segment associated with the task will 
complete the definition of the TTE. 

TTSGSDO: 2 bytes -- Segment directive options 

Bit Meaning 

13 0 - An address is specified in the address field 

for this segment. 

1 - RMS68K supplies logical address equals 
physical address. 

12 0 - Shareable segment is not permanent 

1 - Shareable segment is permanent. 

08 0 - RMS68K does not attempt to allocate the 

segment at the physical address specified in 
the address field for this segment. 

1 - RMS68K attempts to allocate the segment at 
the physical address specified in the address 
field for this segment. Since this is a 
physical address, the logical address will 
equal the physical address. 
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TTSGSSA: 2 bytes -- Segment attributes 


Bit Meaning 


14 

13 

12 

11 


0 - Segment 

1 - Segment 

0 - Segment 

1 - Segment 


s to be read/write, 
s to be read only. 

s not locally shareable, 
s locally shareable. 


0 - Segment is not globally shareable. 

1 - Segment is globally shareable. 


0 - Segment is not memory mapped I/O space. 

1 - Segment is memory mapped I/O space. The 

address given in the address field for this 
segment must be a physical address that is 
not in the limits of allocatable RAM. If 
this bit is set, none of the GTSEG options 
are applicable and the segment is allocated 
as as a shared segment. 


TTSSEGNM: 4 bytes -- Segment name 


This field contains the segment name. 


TTSSEGAD: 4 bytes -- Segment address 

This field contains the segment address. 


TTSSEGSZ: 4 bytes -- Segment size 

This field contains the segment size. 


g. Task Initial State Information 

TTSINITS: 2 bytes -- Task initial state 

This field contains the code of the initial state that this 
task is to have. Valid codes are "R" (ready to execute) 
and "D" (this task is dormant). 

If the initial state does not have a valid value, it will 
default to dormant, "D". 

The high order byte of this word has been reserved for 
future use: 


+ + + 

I Future | State | 

I Use I Code | 

+ + + 
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2.4 CREATING THE TASK TABLE 

TDTI requires a complex TT to drive its startup processing. The complex table 
format provides a great deal of flexibility, but is difficult to create 
manually. The Task Table Generator Utility (TTGEN) provides an easy way for 
the user to create this table. The utility provides a series of simple menus 
which allow creation of a TT of arbitrary length. Most of the low level 
details in the table creation are hidden, thus minimizing the amount of 
information with which the user must deal. 

The output from TTGEN is assembly language source which has been commented to 
make various parts of the table easy to find. After the output has been 
created, it can be combined with other user-written source code and assembled. 

TTGEN will query the user for information required to build the table. Some 
of the information required are the names of the load module files 
representing the tasks that the user wishes to integrate into the system. 
The load module files named must be available for TTGEN to access. Some of 
the information that TTGEN puts into the table is obtained from the first 
sector of the load module file (known as the Loader Information Block -- LIB). 

Because the user interface is very simple, TTGEN may not be able to generate 
some of the more exotic options available through use of the TT. It is 
possible, however, to generate a table that is very nearly complete with 
TTGEN. Any options that cannot be handled by TTGEN can easily be inserted 
into the table with the VERSAdos editor. 


2.4.1 Invoking TTGEN 

The command line to invoke TTGEN is the following: 

=TTGEN [output field] 
where: 

output field is the filename which will receive the output from 

TTGEN. 

If output field is not entered, the output filename will default to TTABLE.SA 
under the current default volume, catalog, and user number. The output field 
must be a file; it cannot be a device such as #PR. 

An initial selection menu will be presented to the user. There are three 
"work" menus and three "help" menus. Each help menu is associated with a 
single work menu. Movement between menus can only take place along the lines 
indicated. 
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The following diagram shows all of the menus and their relationship to one 
another: 


Initial 


Define task table header 

I 

Help menu for header 


selection menu 


Help menu for initial 


selection 


Define single task entry 

I 

Help menu for task entry 


After invoking the TTGEN utility, TTGEN will determine if the output file 
already exists. If so, TTGEN will present the following question to the user. 

Output file "filename" exists - OK to overwrite? (Y/N) 

where filename is the completely qualified output filename. If the user 
answers with N, the utility will terminate with no further action taken. If 
the user answers with Y, the utility will continue. The output file will not 
be overwritten, however, until the user gives the command to configure (build) 
the TT. 


2.4.2 "Initial Selection" Menu 

The "initial selection" menu, along with its associated help menu, is shown 
below: 


Main selection: 

1 - Define Task Table Header 

2 - Define or modify a single table entry 

3 - Delete a single table entry 

C - Configure (Build) the Task Table 
Q - Quit 
H - Help 
Enter selection > 
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HELP (for Initial Selection Menu) 

Selection Description 

1 - (Optional) Displays the menu which allows you to define the task table 

header. If not selected, the task table header will be defined with 
default values. 

2 - Displays the menu which allows you to define an entry in the task table 

for a single task. A load module file for the task must have been 
created prior to building the table entry for that task. 

C - Builds the task table output file using current task table header and 
task table entry values. If an output file exists it will be 
overwritten at this time. 

Q - Terminates the utility without performing any update function. 

Press ’RETURN’ to view initial selection menu 


The menus are self-explanatory. The "default values" mentioned in the help 
menu under item number 1 are presented when the user selects option 1 (define 
TT header). This illustrates an important point: It is not necessary to go 
through every selection item in the work menus. Most of the items will 
default to sensible values if they are not selected by the user. In 
particular, it is not necessary for the user to go though the define TT header 
menu. A default TT header will be defined if the user does not select this 
option. The user may elect to view the define TT header menu by making that 
selection, but it is not necessary to modify any of the default values that 
will be presented by that menu. 

The only way to exit the TTGEN utility is to select the "Q" option when the 
initial selection menu is presented. Selecting the "C" option will cause a 
task table to be built and control to be returned to the initial selection 
menu. If a mistake was made it is still possible to correct it and select the 
"C" option again, which will overwrite the erroneous TT file with the 
corrected information. 
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2.4.3 "Define Task Table Header" Menu 

The "define task table header" menu, along with its associated help menu, is 
shown below: 


Define task table header: 

1 - Table address (hex) Snot def 

2 - Header ID !HDR 

3 - Error Handling Offset (Mnemonic or hex) 0 

Q - Quit (return to initial selection menu) 

H - Help 

Enter selection > 


HELP (for Task Table Header Menu) 


Selection Description 

1 - (Optional) Enter the address that the task table will occupy in memory. 

An ORG statement will be generated reflecting this value. If no 
selection is made, no ORG statement will be generated. 

2 - (Optional) Enter the header ID. The ID is a 4-character alphanumeric 

string. The default value is ’!HDR’. 

3 - (Optional) Enter the error handling offset. The entry may be either hex 

(representing an absolute address where the error handling logic 
resides) or a mnemonic (representing the assembler label of the first 
instruction of the error handling code). If no entry or an entry of 0 
is made, the task initiator will assume there is no error handling code. 


Press ’RETURN’ to view task table header menu 
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Note that all of the selections on the TT header menu are optional. This 
means that it is not necessary to select this menu at all from the initial 
selection menu. If it is not selected, all of the values defined by this menu 
will default. 

Note the following about entering constant data: If selection 1 is chosen, 
TTGEN prompts for entry of the hex value representing the starting address for 
the TT. The value entered may have a leading "$" but it is not required. For 
selection 2 a prompt will ask for entry of the mnemonic representing the 
header ID. ASCII constants must be entered without delimiting quotes. For 
selection 2, if fewer than four characters are entered, the ID will be blank- 
filled on the right. If more than four characters are entered, the ID will be 
truncated from the right to four characters. For selection 3, a prompt will 
ask for entry of either a mnemonic (which corresponds to an assembly language 
label) or a hex value. In this case, the leading "$" is required for the hex 
input since there may be confusion in some cases. The constant ’FADE’ is an 
assembly language mnemonic but the constant "$FADE" is a hex value. 


2.4.4 "Define Single Task Entry" Menu 

The "define single task entry" menu, along with its associated help menu, is 
shown below: 


Define single task entry: ’ZAPP’ 

1 - Load module file name not def 

2 - Task starting address (hex) Snot def 

3 - Task initial state (Ready ’R’ or Dormant ’D’) D 

4 - Task processing priority (decimal) 0 

Q - Quit (return to initial selection menu) 

H - Help 

Next available address = Snot def 

Enter selection > 
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HELP (for Task Entry Menu) 


Selection Description 

1 - Enter the load module filename for the desired task. 

2 - (Optional) Enter the task start address. This address must be in hex 

and represents the address that the first segment of the task will 
occupy. If no entry is made for this selection, the starting addresses 
will be obtained from the load module file. 

3 - (Optional) Enter the task initial state. The two possible responses are 

’D’ for dormant or ’R’ for ready. The default value for this selection 
is ’D’. 

4 - (Optional) Enter the task processing order. The number entered is a 

decimal number in the range 0-32767. The default value is 0. 

Press ’RETURN’ to return to view task entry menu 


When selection 2 is requested from the main menu, a prompt will ask for entry 
of a task entry ID. The ID entered will identify the particular task entry 
being defined. The task entry ID for the above example is "ZAPP". While 
still in the utility, a particular task entry menu can always be recalled 
through use of the associated task entry ID. All the information previously 
defined for that task entry will be displayed if the menu is returned to at a 
later time. When the task table is built, the task entries will be inserted 
into the table in the order in which they were defined. This order is not 
necessarily the order in which TDTI will process the entries. That order is 
determined by the processing order (selection 4) defined for the task entry. 

Note that only the load module filename is required. All of the other entries 
are optional. Most of the information that goes into the TT will be obtained 
from the LIB of the load module file. As mentioned earlier, the load module 
must be available for TTGEN to access. Refer to the M68000 Family Linkage 
Editor User’s Manual for options available when linking a task. 

The "next available address" line in the menu will assume a value when the 
task start address is defined. This value is the address of the byte of 
memory immediately following the last byte of the task defined. This can be 
used as a guide to determine where the next task may begin. TTGEN does not 
enforce address checking, however. It is possible to define tasks with 
overlapping addresses. If a task start address is defined that differs from 
the LIB address defined for that task, TTGEN will automatically bias the 
addresses of all the segments defined for that task by the appropriate amount 
before inserting the information into the TT. No change will be made in the 
load module associated with that task. 
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2.4.5 Modifying TTGEN Output 

This utility is designed to provide a very simple interface to assist the user 
in coding a rather complex TT. As mentioned earlier, it may not be possible 
to produce the TT to support unusual options using TTGEN alone. It is 
possible, however, to produce a TT that is fairly close to the desired form, 
and use the VERSAdos editor to modify the output file that TTGEN produces. 
This section discusses the limitations that may be encountered in using the 
TTGEN utility. 

The first limitation is the inability to use the utility to produce a table 
entry that supports special or "non-standard" processing. Each entry in the 
table produced by TTGEN must have an associated task. It is possible, 
however, to have a table entry that is not associated with any task, but 
merely contains a pointer to some non-standard user-written code that 
executes as a subroutine to the TDTI. The easiest way to handle this is to 
have a small dummy task defined on the system and configure the table entry 
using TTGEN to support that dummy task. After the table is created, the 
editor can be used to insert a pointer to the non-standard code into the cell 
that has the comment "Offset to special non-standard processing". A nonzero 
value here will cause TDTI to ignore all of the information relating to the 
dummy task (other than processing priority) and simply execute the special 
code as a subroutine. 

There is no provision to modify the user-generated task ID. This is the ID 
that is inserted into events queued by the task. This field can easily be 
modified by editing the task entry line that has the comment "User-generated 
task ID". 

Another limitation is the inability to specify segment directive options. 
TTGEN always sets the value $0100 (bit 8 set) into the segment directive 
options field for each segment associated with a task. The option set by 
TTGEN tells TDTI to allocate the segment at the defined physical address. 
This should satisfy most requirements. The other defined options can be 
invoked by simply finding the appropriate segment definition area in the 
output file and editing the "segment directive options" field. Refer to the 
M68000 Family Real-Time Multitasking Software User’s Manual for further 
information about segment directive options. 


2.5 EXAMPLE 

The many menus that appear during the use of the utility preclude presenting a 
complete example of the use of TTGEN; therefore the following example presents 
only the user inputs along with some comments about the menus that are 
displayed. Following the dialog description, the output TT is presented. 
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2.5.1 Interactive Dialog 

The following example represents an unrealistic system, but it illustrates the 
use of the utility to create a TT with two tasks defined. The first task will 
be TTGEN itself (a three-segment task), and the second task will be the 
VERSAdos assembler (a two-segment task). Both of these tasks’ load modules 
should presently be on the VERSAdos media; this example can be performed by a 
user to aid in understanding the use of the utility. User inputs are shown on 
the left along with comments. Entries associated with lower level menus are 
indented. 


=TTGEN 

1 


1 

$2B00 

2 

HEAD 

Q 


Invokes the utility. Since no output file was 
selected, the output filename defaults to TTABLE.SA. 

The user selects option 1 (define TT header). The TT 
header menu is presented. 

Option 1 is selected (table address). 

The table address is defined to start at $2B00. 

Option 2 is selected (header ID). 

The header ID is defined to be "HEAD". Note that 
the ID is entered without delimiting quotes. 

This will return control to the initial selection 
menu. 


2 Option 2 is selected (define single TT entry). 

ZAPP The utility queries the user for task entry ID. The 

entry ID is defined to be "ZAPP". The "define single 
task entry" menu is presented. 


1 Option 1 is selected (load module filename). 

0.. TTGEN. LO The filename is entered in response to the 

utility’s query. 


2 Option 2 is selected (task starting address). 

3000 The starting address is defined to be $3000. 

Note that the leading "$" was not entered here. 
If it had been, the effect would have been the 
same. 


Q This will return control to the main menu. Note 

that task processing order (option 4) was not 
selected. It will default to a value of 0. 
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2 

ZORK 

1 

0..ASN.L0 


2 

$1DE00 

Q 


C 

Q 


2.5.2 TTGEN Output 

The following assembly language code was created by TTGEN from the example 
input just presented: 

PAGE 

* Table driven task initiator (TDTI) startup table. 

* Created with TTGEN 


* 

ORG 

$2B00 


* 

* 

T 

ASK TABLE 

HEADER 


DC.L 

’HEAD’ 

Header ID. 

* 

DC.L 

0 

Address offset of error handling routin 
Zero means no error handling routine. 

* 

DC.L 

4 

Address offset to 1st table entry. 

* 

* 

E 

N D OF TASK 

TABLE HEADER 

* 

PAGE 




TASK ENTRY ZAPP 


TASK TABLE 

Option 2 was selected to define the second task. 

The associated task entry ID is "ZORK". 

Option 1 is selected {load module filename). 

The filename is entered in response to the 
utility’s query. 

Option 2 is selected (task starting address). 

The starting address is defined to be SIDEOO. 

This returns control to the initial selection 
menu. 

This selection causes the task table to be built. 

The utility terminates. 
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★ 


it 


DC.L 

’ZAPP’ 

Task entry ID 

DC.L 

ZAPP END-* 

Offset to next entry 

DC.L 

$0 

Offset to special non-standard processing 

DC.W 

0 

Processing order value 

DC.B 

0 

Reserved 

DC.B 

’D’ 

State (’D’=dormant, ’R’=ready) 

DC.L 

’TTGE’ 

Taskname 

DC.L 

$00000000 

’ ’ Task session number 

DC.W 

%0000000000000000 

TCB directive options 

DC.L 

$0 

Monitor taskname 

DC.L 

$00000000 

’ ’ Monitor session number 

DC.B 

$00 

Task initial priority 

DC.B 

$00 

Task limit priority 

DC.W 

%0000100000000000 

Task attributes 

DC.L 

$00003000 

Task start address 

DC.W 

0 

User-generated task ID 

DC.W 

3 

Number of segments for task 


Segment entry for task ’ZAPP’, segment ’SEGl’ 


DC.W 

%0000000I00000000 

Segment directive options 

DC.W 

%0100000000000000 

Segment attributes 

DC.L 

’SEGI’ 

Segment name 

DC.L 

$00003000 

Start address of segment 

DC.L 

$00005200 

Length of segment 

— 

Segment entry for task ’ZAPP’, segment ’SEG2’ 

DC.W 

%0000000100000000 

Segment directive options 

DC.W 

%0000000000000000 

Segment attributes 

DC.L 

’SEG2’ 

Segment name 

DC.L 

$00008200 

Start address of segment 

DC.L 

$0000C400 

Length of segment 


Segment entry for task ’ZAPP’, segment ’RRTL’ 


DC.W 

%0000000I00000000 

Segment directive options 

DC.W 

%0101000000000000 

Segment attributes 

DC.L 

’RRTL’ 

Segment name 

DC.L 

$00014600 

Start address of segment 

DC.L 

$00008F00 

Length of segment 

EQU 

* 



END OF ENTRY 

FOR -- ZAPP 
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* 

PAGE 


* 

* 

* 

TASK 

ENTRY ZORK 

* 

•k 


DC.L ’ZORK’ 

Task entry ID 



DC.L 0 
DC.L $0 
DC.W 0 
DC.B 0 
DC.B ’D’ 

DC.L ’RASM’ 

DC.L $00000000 

DC.W %0000000000000000 

DC.L $0 

DC.L $00000000 

DC.B $00 

DC.B $00 

DC.W %0000100000000000 
DC.L $0001DE00 
DC.W 0 
DC.W 2 


Offset to next entry 
Offset to special non-standard processing 
Processing order value 
Reserved 

State (’D’=dormant, ’R’=ready) 

Taskname 

’ ’ Task session number 

TCB directive options 
Monitor taskname 
’....’ Monitor session number 
Task initial priority 
Task limit priority 
Task attributes 
Task start address 
User-generated task ID 
Number of segments for task 


Segment entry for task ’ZORK’, segment ’lASM’ 


DC.W %0000000100000000 
DC.W %0101000000000000 
DC.L ’lASM’ 

DC.L $0001DE00 
DC.L $00015C00 


Segment directive options 
Segment attributes 
Segment name 

Start address of segment 
Length of segment 


* Segment entry for task ’ZORK’, segment ’SEG2’ 

* 

DC.W %0000000100000000 
DC.W %0000000000000000 
DC.L ’SEG2’ 

DC.L $00033A00 
DC.L $00009400 

ZORKEND EQU * 


* * 

* END OF ENTRY FOR -- ZORK * 

* * 

* * 

* ENDOFTASKTABLE * 

* * 

* Have a nice day ! * 

* * 


Segment directive options 
Segment attributes 
Segment name 

Start address of segment 
Length of segment 
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CHAPTER 3 

CREATION OF A TDTI OPERATING SYSTEM 


3.1 GENERAL 

There are two types of TDTI operating systems: RMS68K and VERSAdos. The 
VERSAdos TDTI system differs from the RMS68K version in that it includes the 
VERSAdos I/O subsystem and applicable drivers for the user’s application. The 
figure below illustrates the structures of the two types of TDTI systems and 
the necessary user-written portion. 


RMS68K 


VERSAdos 


USER 


+ 

I RMS68K 

+ 

I TDTI 

+ 

I SYSINIT 
+ 


+ 

I 

+ 

I 

+ 

I 

■+ 


I VERSAdos 
I (lOS/FHS) 

+ 

1 DRIVERS 
+ 


+ 

I 

I 

+ 


+ 


+ - -+ 

I USER-WRITTEN | 

I INFORMATION: 1 

1* TASK TABLE | 

I* NON-STANDARD CODE | 
I* ERROR HANDLING | 

I* TASK(S) I 

+ + 


Because the Table Driven Operating System can operate on a target system that 
has a Memory Management Unit (MMU), it is necessary that the TT, any existing 
non-standard user code, and any user-written error handling logic reside in a 
single user-specified partition. TDTI will allocate a segment, using the 
address range for this partition, so that it can access the information 
contained there. The user has complete flexibility, within the address range, 
for his resource allocation. 

In systems which are to be downloaded, a VERSAdos 4.4 limitation requires that 
a RAM partition be logically defined to the system as ROM to prevent 
downloaded information from being cleared at system boot time. The system 
initializer at boot time will zero out all RAM defined in the RAM partitions, 
but will not attempt to initialize a partition defined as ROM. Therefore, to 
prevent destruction of the user’s application task(s), TT, and any non- 
standard user-specified code or error handling logic that has been downloaded, 
a partition defined as ROM must be in the address range of the downloaded 
modules. This modification must be made in the INITDAT.AG module. 

The user application task(s) must also reside in a ROM partition but it does 
not have to be the same ROM partition that contains the TT and optional non- 
standard user specified code or error handling logic. No restrictions have 
been placed on the RMS68K or VERSAdos portions shown above, but the user- 
written information must be defined in one or more ROM partitions. The 
demonstration chainfile discussed in Chapter 4 puts these items into a single 
partition. Note that a partition defined as ROM can physically reside in ROM 
or RAM. 
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On VMEsystems with a MMU and cache memory (MVME120 and MVME121), partition 1 
must be configured. Partition 1 contains the default memory allocated to user 
tasks. Allocating memory from this partition ensures that the base address 
will be on a required 2Kb boundary. 

The above portions can be created separately but they are interrelated via 
address links (pointers). The following defines the relationships that must be 
resolved but does not address the method of implementation to satisfy those 
relationships. 


a. TDTI has three external references defined that must be resolved. 
These references are defined in the user-written information and 
include: 


XREF TTSSA 
XREF AREASA 
XREF AREAEA 


Pointer to the TT header 

Start physical address of ROM partition 

End physical address of ROM partition 


Between the start and end addresses of this ROM partition must be at 
least the following: 


Task table Required 
Error handling logic Optional 
Non-standard user code Optional 


Additional information may reside in this partition at the user’s 
discretion. 


b. Links from user-written code (tasks, error handling logic, and non- 
standard startup logic) to TDTI subroutines must be resolved if TDTI 
subroutines are used. This is optional, and if the user elects to 
write his own code instead of using TDTI subroutines, this 

relationship would not have to be resolved. The following external 
definitions have been defined in TDTI: 


XDEF TI70200 
XDEF TI70500 
XDEF TI71000 
XDEF TI71200 
XDEF TI71300 
XDEF TI72800 


Character fill subroutine 
Create TCB 

Interface to error handling routine 
Get task ID 
Allocate task segments 
Start specified task 


Refer to Appendix D for detailed information on each subroutine. 
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3.2 CREATING THE SYSTEM 

The steps to create an RMS68K or VERSAdos system are as follows: 

a. Execute the TDTIGENI utility to create the arguments required as 
input to the chainfile 9998. TDTI .COPY. CF. The arguments, which 
TDTIGENI stores in the target volume:user number file RESTOREA.CF, 
include the target volumetuser number where the SYSGEN will be 
executed, the source volume where the SYSGEN files reside, the 
VERSAdos catalog for the SYSGEN product, and the type of SYSGEN, 
RMS68K or VERSAdos. Typically the source volume and the target 
volume are the same, but this is not a requirement. When TDTIGENI 
is executed, an interactive dialog begins that displays current 
defaults and prompts the user for input of the arguments. A 
typical example follows: 


=TDTI6EN1 

Target Volume SYS 

Target User Number 8007 

Product Catalog VMEllO 

System Type V 

Source Volume SYS 

Target Volume - Volume where SYSGEN will occur 

Target User Number - User number where SYSGEN will occur 

Product Catalog - VERSAdos catalog for target SYSGEN system 

Type of SYSGEN - R = RMS or V = VERSAdos 

Source Volume - Volume where SYSGEN-related files reside 


C = Configure file with current parameters and Quit 
Q = Quit with no file configuration 

A carriage return retains current value 


Target Volume SYS >{CR) 

Target User Number 8007 >9990 


b. From the target volume:user number enter the following command 
line: 

=source vo7ume:9998.TDTI.C0PY.CF 

This chainfile will copy to the target volume:user number those 
files that require modification. The chainfile will automatically 
modify &.CNFGTASK.CI and TDTI. Cl according to the type of TDTI 
operating system the user has selected. This chainfile uses the 
SYSGEN implementation to resolve the relationship, discussed 
above, between the user-written information and the TDTI task. A 
listing of the chainfile is provided in Appendix C. 
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Upon completion of this chainfile the user is notified of the 
files that must be modified. These files are: 

&.INITDAT.AG Must be modified to reflect the user’s 
partitioning for his SYSGENed system. 

&. TDTI. Cl Must be modified to identify the start/end 

address of the ROM partition that contains the 
TT to be processed as well as the the start 
address of the TT in the partition (an example 
is provided in Appendix B) . 

catalog. CNFGDRVR. Cl 

If this is a TDTI RMS68K operating system, all 
references to any drivers must be removed. If 
this is a TDTI VERSAdos operating system, the 
user should reference only those drivers 
required for his application (an example is 
provided in Appendix B). 

c. Initiate the command line: 

=TDTI. PRODUCT. CF 

from the target volme:user number. The results of this chainfile 
will be the type of TDTI system requested by the user. A listing 
of this chainfile is provided in Appendix C. 


NOTE 

Due to a VERSAdos 4.4 limitation, IDS, FHS, and GET.TASKID.AG 
contain an error which prevents the system from booting if a 
RAM system was SYSGENed without the File Management System 
(FMS). The corrected modules, which the user should apply to 
his system, reside on the latest quarterly update media. 


32 


MICROSYSTEMS 


MOTOROLA 


TDTI SYSTEM EXAMPLE 


CHAPTER 4 

TDTI/VERSAdos SYSTEM EXAMPLE PROGRAM 


4.1 EXAMPLE CHAINFILE 

The VERSAdos software includes, under user number 9990, a chainfile which will 
create an example of a Table Driven Task Initiator (TDTI)/VERSAdos operating 
system containing four tasks, each outputting a message to device CNOO. This 
chainfile, TDTIVDOS. EXAMPLE. CF, will perform all of the steps necessary to 
create a TT, application tasks to use with the system, non-standard user code, 
and error handling logic. The example chainfile target system is an MVMEllO. 
The demonstration chainfile identifies the steps required to create a table 
driven operating system. The implementation scheme, addresses chosen, and 
target system used in this example are not binding on the user but merely 
illustrate one way to create a TDTI/VERSAdos system. 

Listings of files used in this example are provided in appendices, as follows: 

Appendix A -- Example Task Table 

Appendix B -- Files Modified for Example 

Appendix C -- Example Chainfiles 

The creation of the TDTI/VERSAdos system by the example chainfile 

TDTIVDOS. EXAMPLE. CF has two major steps: 

1. Creation of the TDTI system. 

2. Creation of the user-responsible code. 

Step 1 involves the following: 

a. Executing the TDTIGENl utility in the target volume:user number where 
the SYSGEN will occur, to establish the arguments for the execution of 
the chainfile TDTI. COPY. CF. 

b. Initiating the chainfile volume. 9998. TDTI .COPY. CF to copy and identify 
for the user those files that require user modification before the TDTI 
system can be built. The chainfile TDTIUSER. MODIFY. CF reflects these 
changes. 

c. Making modifications to the files that define partitioning, identify 
where the TT resides, and identify the driver that is applicable to 
this application. Files that are modified include: 

&.INITDAT.AG 
&. TDTI. Cl 

catalog. CNFGDRVR. Cl 

d. Initiating the chainfile TDTI . PRODUCT. CF. Upon completion, this chain- 
file will produce the S-record file VMEllO. VERSADOS. MX, which can be 
downloaded. 
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Step 2 involves the following: 

a. Creating the user-required application tasks which are to be executed. 
The chainfile TDTI.APLICATN.CF reflects this information. The files 
related to this application are TSKl.SA, TSK2.SA, TSK3.SA, and TSK4.SA. 

b. Creating the TT and any optional error handling logic or non-standard 
code defined by the user. The error handling logic is in module 
TTSEHL.SA, the TT is in TTS.SA, and the non-standard user-written code 
is in modules TEOlUSC.SA and TE05USC.SA. The implementation to resolve 
the relationships between user-written code and the TDTI referenced 
routines was a SYSGEN. The SYSGEN modules involved are 
TTSUCEHL.SYSGEN.CF and TTSUCEHL.CD. All of these modules reside in 
user number 9990. 

The chainfile TDTITTS. EXAMPLE. CF reflects this information and the SYSGEN 
technique used to collect this information into a single module. 


4.2 EXECUTION OF EXAMPLE CHAINFILE 

To execute the example chainfile, perform the following steps: 

a. Log on to the volume:user number where the SYSGEN is to be executed. 

b. Execute the TDTIGENl utility to define the arguments for the chainfile. 
The VERSAdos catalog for the target system must equal "VMEllO" and the 
type of TDTI system to be created must equal "V", which is the VERSAdos 
system. The other arguments requested by the utility are user- 
selectable. 

c. Initiate the chainfile 9990. TDTIVDOS. EXAMPLE. CF. This chainfile will 
make calls to the following chainfiles from the target volume:user 
number: 

9998. TDTI. COPY. CF 

TDTIUSER. MODIFY. CF 
TDTI. PRODUCT. CF 
TDTI.APLICATN.CF 
TDTITTS. EXAMPLE. CF 

After the chainfiles above have been executed, the user can download all of 
the files with an extension of ".MX" to the MVMEllO system, set the PC and the 
stack register A7, and initiate the process with the GO command. Refer to 
Appendix B for information regarding the startup value. 


4.3 CHAINFILE DESCRIPTIONS 

The following paragraphs explain the function of the chainfiles called by the 
chainfile 9990. TDTIVDOS. EXAMPLE. CF (refer to paragraph 4.2). Refer also to 
Appendix C, which contains listings of these chainfiles. 
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4.3.1 TDTI. COPY. CF 

This chainfile will copy the files that need to be modified to the target 
volume:user number. For demonstration purposes, pre-modified files exist, and 
are copied to the target volume:user number. These pre-modified files reflect 
the configuration of the target MVMEllO system. The files copied are: 

9990. EXAMPLE. INITDAT. AG Defines the example partitioning 

9990. EXAMPLE. TDTI. Cl Defines partitioning addresses 

9990. EXAMPLE. CNFGDRVR. Cl Contains only the ACIA driver 


4.3.2 TDTIUSER. MODIFY. CF 

The changes the user would make are reflected in this chainfile. For this 
example, the following conditions exist: 

RAM partition $40000 - S9FFFF 

ROM partition $300000 - $31EFFF 

ROM partition $31F000 - $31FFFF 

Task table start address - $300AOO 

Only the ACIA driver exists in the system 


4.3.3 TDTI. PRODUCT. CF 

This chainfile will perform the following: 

a. Save the files modified by the user so they will not be destroyed. 

b. Initiate an MVMEllO COPYSGEN process to copy all files required for the 
SYSGEN to the target volumeiuser number. 

c. Re-establish the modified files as the ones to use during the SYSGEN. 

d. Copy the TDTI-related files to the target volumeiuser number. The 
files copied are: 

9998. 6. TDTI. LG 

9998. 6. TDTI. RO 

9998.6. TDTIRSL.CI 

9998.6. TDTIVU.CI 

9998. TTSSA. TDTI. AG 

e. Edit the VERSADOS.CD module to include the TDTI command modules TDTI. Cl 
and TDTIRSL.CI. The TDTI. Cl will define the task attributes for the 
TDTI load module created at SYSGEN time. The TDTIRSL.CI module and the 
function it serves are explained under the discussion of the 
TDTITTS. EXAMPLE. CF chainfile (refer to paragraph 4.3.3). 
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f. Initiate the SYSGEN process to produce the TDTI/VERSAdos system for the 
MVMEllO and build the corresponding module to be downloaded. A by- 
product of this SYSGEN is the file XTDTIVU.CI, whose significance 
will be explained in the discussion of the TDTITTS. EXAMPLE. CF chainfile 
(refer to paragraph 4.3.5). 


4.3.4 TDTI.APLICATN.CF 

This chainfile reflects the application the user has defined for his system. 
As stated previously, there are four tasks outputting a message to device CNOO 
in a never-ending loop. This chainfile assembles, links, and creates the 
modules to be downloaded to the target system. 


4.3.5 TDTITTS. EXAMPLE. CF 

This chainfile creates the module containing error handling logic, non- 
standard user-specified code, and the TT. The TT is required, while non- 
standard user-specified code and the error handling logic are optional. 

This module could have been created in any number of ways, but for this 
demonstration a SYSGEN process was chosen. This implementation was chosen to 
resolve the address references to the TDTI subroutines used by the non- 
standard code in task entry 2. 

For this example chainfile, TT entries 2 and 5 were selected to have non- 
standard user-specified code. Task entry 2 accesses routines used by TDTI to 
perform "standard" processing, but the additional function of starting the 
task with specific address and data register values was added. Since task 
entry two uses TDTI routines, it is necessary to know where the TDTI task 
started and to include the TDTI.RO module at link time to satisfy external 
references to those subroutines referenced by task entry 2. The command 
include file TDTIRSL.CI, which was executed at SYSGEN time for the TDTI 
operating system, created the module XTDTIVU.CI. This module identifies the 
start address of the TDTI module. (Refer to Appendix B.) 

Task entry 5 performs none of the "standard" processing functions, but instead 
initiates the RMS68K directive to delay for five seconds before continuing to 
process the balance of the TT. 

The chainfile copies the following to the target volume:user number: 

a. All non-standard user-specified code 

b. The user-specified error handling logic 

c. Task table-related files 

d. The files needed to execute the SYSGEN for this module (refer to 
Appendix B) . 
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After the 
logic, the 
initiated, 
created. 


files are copied, assemblies are performed on the error handling 
non-standard user-specified code, and the TT. The SYSGEN is 
and upon its completion the corresponding file to be downloaded is 
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38 


MICROSYSTEMS 


@) MOTOROLA 


APPENDIX A 


APPENDIX A 
EXAMPLE TASK TABLE 


A.l EXAMPLE OF TASK TABLE HEADER 


TTSSA: 

DC.L 

* 

★ 

* 

DC.L 

* 

* 

■k 

* 

* 

* 

* 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 


MTTS’ 

User-generated task entry identifier. Eye 

catcher only -- No function associated with 
this field. 

TTSEHL-* 

Self-relative offset to the error handling 
logic to be executed if the TDTI task 
encounters an error while processing the 
TTS. 

If the user elects to return from the error 

handling logic, via an RTS instruction, he 
must preserve the stack pointer. 

Preservation of all other registers will be 
maintained by the Table Driven Task 
Initiator task. Upon return, processing 
will commence with the next TTE. 

If this field is zero the error handling logic 
will not be executed. If an error occurs, 
current TTE will be skipped and processing 
will resume with the next TTE. 

If error handling logic exists and an error is 
encountered, but bit zero of this field is 
set, processing on the current TTE will be 
terminated and the error handling logic will 
not be executed. Processing will commence 
with the next TTE. 


k 

k 


k 


DC.L 


TEID0001-* 


Self-relative offset to the first TTS entry. 

A value of zero implies that there are no 
TTEs. 
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A. 2 EXAMPLE OF "STANDARD" TASK TABLE ENTRY 

TEID0002: 

DC.L ’TE02’ 

* User-generated task entry identifier. Eye 

* catcher only -- no function associated with 

* this field. 

DC.L TEID0003-* 

* Self-relative offset to the next TTE in the TTS. 

* A value of zero implies there are no more 

* TTEs. 


DC.L 0 

* 

* 

* 

* 

* 

* 

■k 

•k 

* 

* 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

DC.W 5 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 


Self-relative offset to the non-standard 
code to be processed for this task. 

A value of zero or an odd value (bit zero set) 
means no non-standard code will be 
executed. 

If non-standard code is to be executed a 
Jump-to-Subroutine (JSR) call will be 
made to the user-written non-standard code. 
The user is responsible for maintaining the 
stack pointer and returning via an RTS 
instruction. Register preservation for 
registers other than the stack pointer will 
be done by the TDTI task. On a call to the 
non-standard code register, A5 will point to 
the TT header, and register A4 will point to 
the TTE to be processed. 

The user is responsible for performing all 
actions normally done by the TDTI task. 
Routines normally accessed by the TDTI task 
will be accessible to the non-standard code 
Upon return from the non-standard code the 
TDTI task will commence processing with the 
next task. 

Since the offset will always be an even value, 

bit zero was chosen so the user could easily 
alter the flag and not destroy the offset 
value. 

This implementation will allow the user to easily 
execute or not execute his non-standard 
code. 

This word contains the task processing order. 

The execution order is from low to high. 

If a TTS had four TTEs as follows: 

TTS PROCESSING ORDER 

ENTRY VALUE 

1 31 

2 10 

3 17 

4 35 
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DC.B 0 

DC.B ’R’ 


The TTE processing would be TTE2, TTE3, 

TTEl, followed by TTE4. 

If multiple Task Table Entries with the same 
processing order value exist, the Task Table 
Entries will be processed sequentially from 
the first entry to the last entry. 

If a TTS had four TTEs as follows: 

TTS PROCESSING ORDER 

ENTRY VALUE 

1 31 

2 05 

3 17 

4 05 

the TTE processing would be TTE2, TTE4, 

TTE3, followed by TTEl. 

If this field has bit 15 set, this task 

entry will be ignored and the next task 
table entry will be processed. 

Since the processing order will never be a 
negative number, bit 15 was chosen so 
the user could easily alter the flag and 
not destroy the processing order value. 


This word contains the code of the initial 
state that this task is to have. 

Valid codes are: 

’R’ Ready to execute 
’D’ This task is dormant 
If the initial state does not have a valid value 
it will default to dormant, ’D’. 

The high order byte of this word has been 
reserved for future use. 


DC.L 

DC.L 

DC.W 

DC.L 

DC.L 


+ + + 

I Future | State | 

I Use { Code j 

+ + + 


’TSK2’ 

’ 0020 ’ 

0 

0 


0 


Task name 

Task session number 
TCB directive options 
Monitor task name 
Monitor task session number 
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★ 

* 

* 

it 

* 

it 


* 

* 

* 

* 

it 

it 

it 

it 

* 

* 

* 

* 

* 

* 

* 

* 

it 

* 

* 

* 

it 

* 

* 


* 

it 


* 


it 

it 


it 


it 

it 


it 


* 


DC.B 

DC.B 

DC.W 

DC.L 

DC.W 

DC.W 

DC.W 


DC.W 


$42 

$7F 

0 

$312000 

0 

2 


Task initial priority 

Task limit priority 

Task attributes 

Task entry point address 

User generated identification for task 

Number of segments associated with task 


$0100 

Segment Directive Options 
Bit Meaning 

13 0 - An address is specified in the 

address field for this segment. 

1 - RMS68K supplies logical address 
equal to physical address. 

12 0 - Shareable segment is not permanent. 

1 - Shareable segment is permanent. 

8 0 - RMS68K does not attempt to allocate 

the segment at the physical address 
specified in the address field for 
this segment. 

1 - RMS68K attempts to allocate the 
segment at the physical address 
specified in the address field 
for this segment. 

Since this is a physical address, 
by definition logical address will 
equal physical address. 


0 


Segment Attributes 


Bit 

Meaning 

14 

0 - Segment 


1 - Segment 

13 

0 - Segment 


1 - Segment 

12 

0 - Segment 


1 - Segment 


is to be read/write, 
is to be read only, 
is not locally shareable, 
is locally shareable, 
is not globally shareable, 
is globally shareable. 
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DC.L 

DC.L 

DC.L 

DC.W 


DC.W 


’SEGO’ 

$312000 

$200 

$1100 


Segment name 

Segment address 

Segment size in bytes 

Segment Directive Options 
Bit Meaning 

13 0 - An address is specified in the 

address field for this segment. 


1 - RMS68K supplies logical address 
to equal physical address. 


12 0 - Shareable segment is not permanent. 

1 - Shareable segment is permanent. 

8 0 - RMS68K does not attempt to allocate 

the segment at the physical address 
specified in the address field for 
this segment. 

1 - RMS68K attempts to allocate the 
segment at the physical address 
specified in the address field 
for this segment. 

Since this is a physical address, 
by definition logical address will 
equal physical address. 


$1000 

Segment Attributes 
Bit Meaning 

14 0 - Segment is to be read/write. 

1 - Segment is to be read only. 

13 0 - Segment is not locally shareable. 

1 - Segment is locally shareable. 

12 0 - Segment is not globally shareable. 

1 - Segment is globally shareable. 
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11 0 - Segment is not memory mapped I/O 

space. 

1 - Segment is memory mapped I/O 
space. The address given in the 
address field for this segment 
must be a physical address that is 
not in the limits of allocatable 
RAM. If this bit is set, none of 
the GTSEG options are applicable 
and the segment is allocated as 
a shared segment. 


DC.L 

’SEGC’ 

DC.L 

$31F000 

DC.L 

$100 


Segment name 
Segment address 
Segment size in bytes 
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APPENDIX B 
I 

FILES MODIFIED FOR EXAMPLE 


B.l TDTI.CI MODULE 


MSG 

************************************************************* 

MSG 

k 


* 

MSG 

* Link the TDTI task 


* 

MSG 

* 


* 

MSG 

************************************************************* 

AREASA 


Partition start address of segment 

* 


containing 


* 


Task Table Structure 

Required 

■k 


Error Handling Logic 

Optional 

* 


Non-Standard Code 

Optional 

AREAEA 

= $77777777 

Partition end address for 

above segment 

TTSSA 

= t77777777 

Task Table start address 


STDTISA 

= \PC 



TASK 

&.TDTI.LO 



STATE 

= ’READ’ 



ATTRIB 

= ’RTIM’ 



ATTRIB 

= ’CRIT’ 



ATTRIB 

= ’SYST’ 



SESSION 

= 1 



PRIORITY = $C8 



SUBS 

TTSSA. TDTI. AG 



ASM 

TTSSA. TDTI. AG, TTSSA. TDTI. 

RO,\ASMLS;R 


IFEQ 

\ASMLSW 



=COPY 

\ASMLS,\WORKLS;A 



ENDC 




SUBS 

&. TDTI. LG 



LINK 

&. TDTI. LG 



IFEQ 

\LINKLSW 

=COPY \LINKLS,\WORKLS;A 



ENDC 




END 

•k 

k 

k 

TDTI 
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Modifications to TDTI.CI Module 
=/* 

=/* Edit the TDTI.CI module to establish the following: 

=/* 

=/* Address range of the ROM partition defined for this example 

=/* This ROM partition must contain at a minimum 

=/* The Task Table Required 

=/* Non-standard user-specified code Optional 

=/* User-written error handling code Optional 

=/* Start address, in this address range, of the Task Table 

=/* 

=E &. TDTI.CI 
F /AREASA/ 

C /$????????/$00300000/ 

F /AREAEA/ 

C /$????????/$003IEFFF/ 

F /TTSSA/ 

C /$????????/$00300A00/ 

QUIT 
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B.2 VMEllO.CNFGDRV.CI MODULE 


=/* 

=/* Edit VMEllO.CNFGDRVR.CI 

=/* 

=/* Remove drivers not required for this application. 

=/* 

=E VMEllO.CNFGDRVR.CI 


F /NORWIN 

= 1/ 


C /NORWIN 

= 1/NORWIN 

= 0/ 

F /NVME315 

= 1/ 


C /NVME315 

= 1/NVME315 

= 0/ 

F /NVME320 

= 1/ 


C /NVME320 

= 1/NVME320 

= 0/ 

F /NVME4205 

= V 


C /NVME4205 

= 1/NVME4205 

= 0/ 

F /NVME400 

= 1/ 


C /NVME400 

= 1/NVME400 

= 0/ 

F /NVME410 

= 1/ 


C /NVME410 

= 1/NVME410 

= 0/ 


QUIT 


B.3 EXCERPT FROM VMEllO.SYSLIST.LS IDENTIFYING STARTING ADDRESS, $49700, OF 
TDTITASK AND STARTUP ADDRESS, $4ABOO, FOR THE SYSTEM 


FILE NAME 

TASK 

PROC 

SEG 

ADDR 

TCB 

RMS.LO 


RMS 

RMSO 

$040000 





RMS2 

$040100 


DRVLIB.LO 


DRVL 

DRVL 

$044E00 


TERMLIB.LO 


TERM 

TERM 

$045000 


ACIADRV.LO 


AC I A 

AC I A 

$046300 


FHS.LO 

.FHS 


.FHS 

$046600 

$ 047A00 

lOS.LO 

.lOS 


.lOS 

S047COO 

$ 049500 

TDTI.LO 

TDTI 


TDTI 

$049700 

$ 049C00 

lOI.LO 

.101 


lOSG 

$049E00 

$ 04A900 




.101 

$04A500 


SYSINIT.LO 


SYSI 

.INT 

S04ABOO 



- FINAL PC VALUE = $048500 

- START-UP ADDRESS = $04AB00 
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B.4 TTSUCEHL.SYSGEN.CF RELATED MODULES 


_^********************** 

=/* TTSUCEHL.SYSGEN.CF * 

=^********************** 

=0PT K,N 

*************************************************************************** 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=0PT J,-N 
=TIME 

=SYSGEN &.TTSUCEHL.CDA1:\2/&.TTSUCEHL.SY,&.TTSUCEHL.LS 
=/* 

=0PT -N 

_y*************************************************************************** 

=/** 

=/** Sysgen Completed -- 
=/** 


'* 

'* 

SYSGEN for 


’* 

Task Table 

Required 

'■k 

Non-Standard User Code 

Optional 

'* 

Error Handling Logic 

Optional 


a-/*************************************************************************** 

=0PT -K 
=END 


B.4.1 TTSUCEHL.CD -- SYSGEN Command File for Sample System 


* 

* TTSUCEHL.CD 

* 

* This command file is used to accumulate the following modules 

* 

* Task Table Required 

* Non-standard user code Optional 

* Error Handling Logic Optional 

* 

* The addresses should reflect those to be processed by the 

* Table Driven Task Initiator task (TDTI). 

* 


INCLUDE &.XTDTIVU.CI 
* 

* Start address of TDTI task 

* 

TDTISTRT = \TDTISA 


* The following flags are defined as follows 

★ 
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* 

* 

* 


Non-zero --> The information exists 

Zero --> The information does not exist 


FLAGEHL 

FLAGUSC 


1 Flag for Error Handling Logic 

1 Flag for User-Specified Code 


IFNE \FLAGEHL 

MSG *************************************************** 

MSG * * 

MSG * Process the Error Handling Logic * 

MSG * * 

**★*★*★★★★********★*****★**★*****★★*★***★★★*★★★***★ 

INCLUDE &.TTSEHL.CI 
ENDC 


IFNE \FLAGUSC 

*************************************************** 
MSG * * 

MSG * Process User-Specified Code * 

MSG * * 

f^2Q *************************************************** 

INCLUDE &.TE01USC.CI 
INCLUDE &.TE05USC.CI 

ENDC 


*************************************************** 
MSG * * 

MSG * Process the Task Table Structure * 

MSG * * 

*************************************************** 

INCLUDE &.TTS.CI 


END SYSGEN 
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B.4.2 TTSEHL.CI -- SYSGEN Include File for Error Handling Code 
* 

* TTSEHL.CI 

* 

* This command file has been built to create a task table 

* Error Handling Logic module. 

* 

* STARTEHL = Start address of the Error Handling Logic. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 

* 

PC = $300000 


STARTEHL = * 


SUBS 

Si. TTSEHL.LG 

LINK 

&. TTSEHL.LG 

PROCESS 

&. TTSEHL.LG 

END 

ic 

TTSEHL 

* 


★ 



B.4.3 TTSEHL.LG -- SYSGEN Link File for Error Handling Code 


=/* 

=/* TTSEHL.LG 

=/* 

=/* Link chainfile to create TTSEHL.LG 

=/* 

=/* 

=LINK ,TTSEHL.LO,TTSEHL.LL;HAMIX 
SEGMENT EHLOrl \PC 
INPUT &. TTSEHL.ro 
END 

=/* 

=END 
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B.4.4 &.TE01USC.CI -- SYSGEN Include File for Task 1 
* 

* &.TE01USC.CI 

* 

* This command file has been built to create a non-standard code 

* module for use with the Table Driven Task Initiator task. 

■k 

* SUSCTEOI = Start address of the User-Specified Code. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 

* 

* 


PC = $300500 


SUSCTEOI = 

* 

EXCLUDE 

TDTI 

SUBS 

&. TEOlUSC.LG 

LINK 

&. TEOlUSC.LG 

PROCESS 

&.TE01USC.L0 

END 

TEOlUSC 

* 


* 


* 



B.4.5 TEOlUSC.LG - SYSGEN Link File for Task 1 


=/* 

=/* 

=/* 

=/* 


TEOlUSC.LG 

Link file to link non-standard code for this task entry 


=LINK ,&.TE01USC.LO,&.TE01USC.LL;HAMIX 
SEG TDTI:0 \TDTISTRT 
SEG T01U:2 \PC 

IN ttssa.tdti.ro 
IN &. TDTI.ro 
IN &. TE01USC.ro 
END 


=END 
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B.4.6 &.TTS.CI -- SYSGEN Include File for Task Table 


* &.TTS.CI 

* 

* This command file has been built to create the task table 

* module for use with the Table Driven Task Initiator task. 

* 

* STARTTTS = Start address of the Task Table Structure. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 


PC = $300A00 

STARTTTS = * 

SUBS &.TTS.LG 

LINK &.TTS.LG 

PROCESS &.TTS.L0 

END 
* 

* 

* 


B.4.7 TTS.LG — SYSGEN Link File for Task Table 


=/* 

=/* TTS.LG 
=/* 

=/* Link chainfile to create TTS.LO 
=/* 

=LINK ,&.TTS.LO,TTS.LL;AHMIX 
DEFINE TTSEHLASTARTEHL 
DEFINE TEOlUSCASUSCTEOl 
DEFINE TE05USCASUSCTE05 
SEG TTS0:4 \PC 
INPUT &.TTS.R0 
END 

=/* 

=END 
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B.4.8 TE05USC.SA -- Sample User Code That Does Not Initiate Task 


PAGE 

NOLIST 

INCLUDE 

LIST 

PAGE 


&.TR1.EQ 


External definitions 


XDEF 

PAGE 


TE05USC 


it 

it 

it 

it 

it 

it 

it 

* 


It should be noted that this user-specified code has been used to 
execute a delay for 5 seconds before returning control back 
to the TDTI task. This example of user-specified code has been 
included to illustrate that there are other functions that the 
user specified code could be used for other than performing the 
standard TDTI functionality. This particular usage provides the 
the user the capability to complement the order in which tasks are 
executed by adjusting the timing of their execution. 

PAGE 

SECTION 3 

TE05 User Specified Code 
INPUT 

A4 = Address of TTE to be processed 
A5 = Address of TTS 


TE05USC: 

* 


MOVE.L 

MOVE.L 

TRAP 

RTS 

END 


#{5*1000),A0 

A0= Number of milliseconds to delay 

#DELAY,D0 

DO = Directive for this request 

#1 

Initiate request 
DELAY 

Return to TDTI task 
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B.4.9 TDTIRSL.CI -- SYSGEN Include File Used for Sample System 


SUBS &.TDTIVU.CI 

* Substitute into the TDTI VersaUser command file 

* which will be used later on in the example by 

* the SYSGEN that creates the VERSAdos module and 

* the SYSGEN that creates the Task Table Structure 

* 

* The results of the substitution is the module 

* XTDTIVU.CI 


B.4.10 TDTIVU.CI 


The values defined in this file will be used by the 
VERSAdos SYSGEN and the 
Task Table SYSGEN 


TDTISA = \STDTISA 

* Starting address where the Table Driven Task Initiator 

* task is located 
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APPENDIX C 

CHAINFILES USED IN EXAMPLE 


C.l TDTI.COPY.CF 


=0PTI0N K 
=/* 

=/* OPTION K means: 

=/* Do not translate LOWER case to UPPER case 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 


TDTI.COPY.CF 

Chainfile to perform the preliminary steps required prior to 
executing the chainfile TDT I. PRODUCT. CF which will generate an ’RMS’ 
or a ’VERSAdos’ Table Driven Task Initiator (TDTI) system. 

Completion of this chainfile will identify the files to be modified 
by the user prior to user invocation of the TDTI. PRODUCT. CF 
chainfile. 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/& 


CHAIN INVOCATION 

Log on to volume: user number where SYSGEN will be executed 
Respond to prompt with <Source Volume>:9998. TDTI.COPY.CF 

Press RETURN to continue 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/& 


Chainfile Assumptions 

1. The user has executed the TDTIGENl utility, which creates the 
file RESTOREA.CF which is REQUIRED input for this chainfile. 
The file RESTOREA.CF contains the following: 

Name of Source Volume which contains all the files 
required to execute this chainfile 
Target volume: user number where SYSGEN will occur 
VERSAdos target system catalog identification for the 
target system (VM04, VMEllO, etc.) 

Type of sysgen: RMS or VERSAdos 

2. The file RESTOREA.CF resides in the volume:user number where 
this chainfile will execute. 

Press RETURN to continue 
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=/* 

=/* Establish the original arguments for this chainfile 
=/* 

=/@ &.RESTOREA.CF 
=/* 

=/* Chainfile assumptions based on file RESTOREA.CF 
=/* 

=/* 1. Chainfile will use \1:\2.\3 

=/* to execute the SYSGEN 

=/* 2. All files required to execute this chainfile reside on 

=/* volume \5 and will be copied to \1:\2 

=/* 3. The type of sysgen is for 

=/IFEQ "R"\4 

=/* ’RMS’. 

=/ENDIF 

=/IFEQ "V"\4 

=/* ’VERSAdos’. 

=/ENDIF 

=/* 

=/& Press RETURN to continue Press BREAK to terminate 
=/* 

=/* Establish volume:user number as \1:\2 

=/* 

=USE \1:\2.& 

=/* 

=/* Copy chainfiles to be modified to \1:\2.& 


=/* 

=C0PY \5:9998.&.CNFGTASK.CI \1:\2;YC 
=C0PY \5:9998.&.INITDAT.AG \1:\2;YC 
=C0PY \5:9998.&.TDTI.CI \1:\2;YC 
=C0PY \5:9998.\3.CNFGDRVR.CI \1:\2;YC 
=C0PY \5:9998.TDTI. PRODUCT. CF \1:\2;YC 


=/IFEQ "R"\4 


=/* 


=/* 

Build &.CNFGTASK.CI for the RMS : 

=/* 


=/* 

Remove the following from the sy: 

=/* 

I/O Request 

=/* 

File Handling 

=/* 

File Management 

=/* 

Session Control 

=/* 

Loader 

=/* 

For the RMS SYSGEN these modules 

=/* 


=E &.CNFGTASK.CI 

F /FHS$I0S$ = 1/ 

C /FHS$I0S$ = 1/FHS$I0S$ = 0/ 

F /FMS$ 

= 1/ 

C /FMS$ 

= 1/FMS$ = 0/ 

F /EET$ 

= 1/ 


sysgen 
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C /EET$ 

F /LDR$ 

C /LDR$ 

QUIT 

=/endif 

=/IFEQ 
=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=E &.CNFGTASK.CI 
F /FMS$ = 1/ 

C /FMS$ = I/FMS$ = 0/ 

F /EET$ = 1/ 

C /EET$ = 1/EET$ = 0/ 

F /LDR$ = 1/ 

C /LDR$ = I/LDR$ = 0/ 

QUIT 

=/* 

=/* Place the TDTI task in the dormant state. The lOI task will 
=/* START this task prior to terminating itself. 

=/* 

=E &. TDTI. Cl 
F /READ/ 

C /READ/DORM/ 

QUIT 

=/ENDIF 


= l/EETS 

= 0/ 

= 1/ 


= 1/LDR$ 

= 0/ 


"V"\4 

Build &.CNFGTASK.CI for the VERSAdos sysgen 

Remove the following from the system 
File Management 
Session Control 
Loader 

For the VERSAdos SYSGEN these modules are not needed. 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 


The following files require modification prior to invoking 
\1:\2. TDTI. PRODUCT. CF 

\I:\2.&.INITDAT.AG 

\I:\2.&.TDTI.CI 

\1:\2.\3.CNFGDRVR.CI 

\1:\2.&.INITDAT.AG 

Must be modified to reflect the user’s 
partitioning 

\1:\2.&.TDTI.CI 

Must be modified to identify the start/end 
address of the ROM partition that contains 
the task table to be processed as well as the 
start address of the task table in the 
partition 
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=/IFEQ "R"\4 

=/* \1:\2.\3.CNFGDRVR.CI 

=/* All references to any drivers must be removed 

=/ENDIF 

=/IFEQ "V"\4 

=/* \1:\2.\3.CNFGDRVR.CI 

=/* The user should reference only those drivers 

=/* required for his application. 

=/ENDIF 

=/& Press RETURN to continue 

=/* 

=/* When the user has modified the above files he may initiate the 
=/IFEQ "R"\4 

=/* RMS sysgen by invoking the following command line 

=/ENDIF 

=/IFEQ "V"\4 

=/* VERSAdos sysgen by invoking the following command line 

=/ENDIF 

=/* \1 :\2.TDT I. PRODUCT. CF 

=END 


C.2 DTIUSER. MODIFY. CF 


=/* 

=/* TDTIUSER. MODIFY. CF 

=/* 

=/* This chainfile reflects changes the user would have to make 
=/* to satisfy the needs required for his application. In our example 

=/* the files have already been modified and exist in user number 

=/* 9990. This chainfile merely copies the already modified modules 

=/* to the target sysgen user number. 

=/* 

=/& PRESS RETURN to continue 

=/* 

=/* Restore the arguments established by TDTI.COPY.CF 

=/* 

=/@ &.REST0REA.CF 

=C0PY \5 : 9990 . EXAMPLE . IN ITDAT . AG , \1 : V • & . IN ITDAT . AG ; YC 

=C0PY \5 : 9990 . EXAMPLE . TDTI . C I , \1 : \2 • TDTI . C I ; YC 

=C0PY \5:9990.EXAMPLE.CNFGDRVR.CI,\1:\2.VME110.CNFGDRVR.CI;YC 


=END 
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C.3 TDTI. PRODUCT. CF 


=/* 

=/* TDTI. PRODUCT. CF 

=/* 

=/* 

=/* Establish the original chainfile arguments established when 

=/* TDTI. COPY. CF was executed 

=/* 

=/@ &.RESTOREA.CF 

=/* Chainfile to produce 

=/IFEQ "R"\4 

=/* an RMS 

=/ENDIF 

=/IFEQ "V"\4 

=/* a VERSAdos 

=/endif 

=/* Table Driven Task Initiator (TDTI) system. 

=/* 

=/* CHAIN INVOCATION 

=/* 

=/* Log on to volume: user number where SYSGEN will be executed. 

=/* Respond to prompt with TDTI. PRODUCT. CF 

=/* 

=/* 

=/* Chainfile ASSUMPTIONS: 

=/* 

=/* I. Chainfile will use \1:\2.\3 

=/* to execute the SYSGEN 

=/* 2. All files required to execute this chainfile reside on 

=/* volume \5 and will be copied to \1:\2 

=/* 3. The type of sysgen is for 

=/IFEQ "R"\4 

=/* ’RMS’. 

=/ENDIF 

=/IFEQ "V"\4 

=/* ’VERSAdos’. 

=/endif 

=/* 4. File TDTI. COPY. CF has already been executed. 

=/* 

=/& Press RETURN to continue Press BREAK to terminate 

=/* 

=/* Establish the target volume: user number. catalog \1:\2.\3 

=/* 

=USE \1:\2.\3 
=/* 

=/* Save the files that have been modified so that they are not destroyed 


59 


MICROSYSTEMS 


(g) MOTOROLA 


APPENDIX C 


=/* 

=COPY &. INITDAT.AG,&. INITDAT.GA;Y 
=COPY \3.CNFGDRVR.CI,\3.CNFGDRVR.IC;Y 


=/* 

=/* Perform the COPYSGEN for the target system 
=/* 

=/@ \5: 9998. \3. COPYSGEN. CF \S,\1,\2 


=/* Establish the original chainfile arguments established when 

=/* TDTI.COPY.CF was executed 

=/* 

=/0 &.RESTOREA.CF 


=/* Re-establish the files modified by the user when TDTI.COPY.CF 

=/* was executed 

=/* 

=C0PY &.INITDAT.GA,&.INITDAT.AG;YC 
=C0PY \3 . CNFGDRVR . IC , \3 • CNFGDRVR . Cl ; YC 


=/* Copy the TDTI related modules to the target volume: user number 

=/* \ 1:\2 

=/* .... 


=C0PY \5:9998.&.TDTI.LG \1:\2;YC 
=C0PY \5:9998.&.TDTI.R0 \1:\2;YC 
=C0PY \5:9998.&.TDTIRSL.CI \1:\2;YC 
=C0PY \5:9998.&.TDTIVU.CI \1:\2;YC 
=C0PY \5 ; 9998. TTSSA. TDTI. AG \1:\2;YC 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 


Edit \1:\2.&.VERSAD0S.CD for the SYSGEN 

Merge the command file for the task initiator module and the 
command module TDTIRSL.CI whose output, &.XTDTIVU.CI , will be used 
in the SYSGEN for the Task Table. 


=E &.VERSADOS.CD 
F /FHS$I0S$/ 

UP 1 

MERGE &. TDTI. Cl 
F /= \&SERFLAG/ 

D 1 

MERGE &. TDTIRSL.CI 
QUIT 


=/IFEQ "V"\4 
=/* 
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=/* The VERSAdos 4.4 version of IDS and FHS and GET.TASKID.AG modules had 

=/* an error that occurred at boot time if the SYSGEN was for a RAM 

=/* system without the file handling module (FMS). These modules have 

=/* been corrected to eliminate that problem and must overlay the modules 

=/* copied over during the copysgen. 

=/* 

=C0PY \5:9990.DEVICE.IOS.RO,\1:\2;YC 
=C0PY \5 : 9990 . DEVICE . FHS . RO, \1 :\2 ; YC 
=C0PY \5 :9990. FILE. IDS. R0,\1:\2;YC 
=C0PY \5:9990.FILE.FHS.R0,\1:\2;YC 
=C0PY \5:9990.GET.TASKID.AG,\1:\2;YC 

=/* 

=/* The lOI module was modified to start the TDTI task prior to 
=/* terminating. 

=/* 

=C0PY \5:9990.&.IOI.RO,\1:\2.&.IOI.RO;YC 

=/ENDIF 

=/* 

=/* Perform the TDTI SYSGEN 

=/* 

=/@ \1:\2.STD.SYSGEN.CF 
=/* 

=/* Establish the original chainfile arguments established when 

=/* TDTI. COPY. CF was executed 

=/* 

=/0 &.RESTOREA.CF 
=/* 

=/* Build the <system>. VERSADOS. MX module to be downloaded 

=/* 

=DEL \3. VERSADOS. MX 

=BU I LDS \3 . VERSADOS . SY , \3 • VERSADOS . MX 

=/* 

=/* Two files that are produced as a result of this chainfile are 
=/* &.XTDTIVU.CI and TDTI.LO. If the user has non-standard user-specified 

=/* code that references routines in the TDTI module, these files can 

=/* be of value in reducing the amount of user-specified code required. 
=/* Reference files TTSUCEHL.CD, TEOlUSC.CI, and TEOlUSC.LG as an example 
=/* of how these files have been used. 

=/* 

=END 


61 


MICROSYSTEMS 


(g) MOTOROLA 


APPENDIX C 


C.4 TDTI.APLICATN.CF 


=OPTION K 


=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=/0 


OPTION K means: 

Do not translate LOWER case to UPPER case 

This chainfile contains the user application related functions. 
CHAIN INVOCATION 

This chainfile is called by the example chainfile and as such 
the existing arguments defined by the example chainfile are 
applicable here. 

Chainfile arguments 

&.RESTOREA.CF 


=/* Copy the application tasks to be processed 
=/* 

=C0PY \5:9990.*.TSK*.*,\1:\2.*.TSK*.*;Y 
A 

=/* 

=/* Assemble the tasks to be processed 
=/* 

=N0ARG 

=/@ TSKl.AF 

=N0ARG 

=/0 TSK2.AF 

=N0ARG 

=/0 TSK3.AF 

=N0ARG 

=/0 TSK4.AF 

=N0ARG 

=/0 TSK2TSK3.AF 
=/* 

=/* Link the tasks to be processed 
=/* 

=N0ARG 

=/0 TSKl.LF 

=N0ARG 

=/0 TSK2.LF 

=N0ARG 

=/0 TSK3.LF 

=N0ARG 

=/0 TSK4.LF 

=/* 

=/* Build the corresponding task files to be downloaded 
=/* 

=/0 TSKl.CF 
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=/@ TSK2.CF 
=/@ TSK3.CF 
=/@ TSK4.CF 

=END 


C.5 TDTITTS. EXAMPLE. CF 


=OPTION K 


=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/* 
=/0 & 

=/* 

=/* 

=/* 

=/* 

=/* 

=/* 

=COPY 

=COPY 

A 

=COPY 

A 


OPTION K means; 

Do not translate LOWER case to UPPER case 


This chainfile processes the Task Table, error handling logic, 
and non-standard user specified code. 

CHAIN INVOCATION 

This chainfile is called by the example chainfile and as such 
the existing arguments defined by the example chainfile are 
applicable here. 

Chainfile arguments 

RESTOREA.CF 


Copy the 

User-specified code that may exist to the target 
SYSGEN user number 


\5: 9998. TEMPLATE. TDTITTS. AI,\1:\2;YC 
\5:9990.*.TE05*.*,\1:\2.*.TE05*.*;Y 

\5:9990.*.TE01*.*,\1;\2.*.TE01*.*;Y 


=/* 

=/* Copy the 

=/* Error Handling Logic modules to the target 

=/* SYSGEN user number 

=/* 

=/* 

=C0PY \5:9990.&.TTSEHL.*,\1:\2.&.TTSEHL.*;Y 
A 


=/* 

=/* Copy the 
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=/* Task Table Structure modules to the target 

=/* SYSGEN user number 

=/* 

=/* »»> 

=/* »»> The user should examine Task Table Structure (TTS) entries 2 and 
=/* »»> 5. Both of these entries have user-specified code yet illustrate 
=/* »»> different types of usage for user-specified code. 

=/* »»> 

=/* 

=C0PY \5:9990.*.TTS*.*,\1:\2.*.TTS*.*;Y 
A 

=/* 

=/* Copy the file to initiate a SYSGEN to accumulate the following 

=/* Task Table Structure Required 

=/* Non-Standard User Code Optional 

=/* Error Handling Logic Optional 

=/* 

=C0PY \5 : 9990 . TTSUCEHL . SYSGEN . CF , \1 :\2 ; YC 
=/* 

=/* Assemble the user-specified code 
=/* 

=N0ARG 

=/@ &.TE05USC.AF 
=N0ARG 

=/@ &.TE01USC.AF 
=/* 

=/* Assemble the Error Handling Logic module 
=/* 

=N0ARG 

=/@ TTSEHL.AF 
=/* 

=/* Assemble the Task Table Structure 
=/* 

=N0ARG 
=/@ TTS.AF 

=/* 

=/* Restore the arguments established by TDTI.COPY.CF 
=/* 

=/0 &.REST0REA.CF 
=/* 

=/* Establish volume:user number. catalog as \1:\2.& 

=/* 

=USE \1:\2.& 

=/* 

=/* Execute a SYSGEN to create the module containing 
=/* 
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=/* Task Table Structure Required 

=/* User Specified Code Optional 

=/* Error Handling Logic Optional 

=/* 

=/0 TTSUCEHL.SYSGEN.CF 
=/* 

=/* Build the corresponding user-specified code to be downloaded 
=/* 

=/0 TTSUCEHL.CF 


=END 
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APPENDIX D 

ACCESSIBLE TDTI ROUTINES 
D.l TI70200 - CHARACTER FILL 


****************************************************************************** 


*** 

INTERNAL 

SUBROUTINE: TI70200 

kki 

•k*-k 



kki 

*** 

DESCRIPTION: 

kkk 

ic*ie 



kkk 

*** 

Subroutine to character fill a specified area. 

kkk 

*** 



kkk 

*** 



kkk 

*** 

NOTES: 


kkk 

*** 


N/A 

kkk 

*** 


kkk 

-k-k-k 

REGISTER 

USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 


*** 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

*** 

kkk 


kkk 

kkk 

D: 

ARPPPPPPP 

kkk 

kkk 

A: 

ARPPPPPPP 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

INPUT: 


kkk 

kkk 


AO = Start address of area to character fill 

kkk 

kkk 



kkk 

kkk 


DO = Low order byte of low order word contains fill 

kkk 

kkk 


character 

kkk 

kkk 


High order byte of low order word is for future 

kkk 

kkk 


use 

kkk 

kkk 


High order word contains number of bytes to move 

kkk 

kkk 


kkk 

kkk 


+ + + + + 

kkk 

kkk 


1 Number of bytes to | Future | Fill | 

kkk 

kkk 


1 character fill | use | character! 

kkk 

kkk 


+ ---+ ---+ ---+ + 

kkk 

kkk 



kkk 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


AO = Unchanged 

kkk 

kkk 


DO = Unchanged 


kkk 


kkk 

kkk 

CONDITION CODES 

kkk 

kkk 


NOT-EQUAL --> Number of bytes to character fill is 

kkk 

kkk 


zero or negative 

kkk 

kkk 


EQUAL --> Specified data area was character filled 

kkk 

kkk 


kkk 


****************************************************************************** 
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D.2 T I 70500 -- CREATE TCB 


*-k-k*'k-k-kit-k*-k-k-kitie-k-k*-k'k-kie-kici(ic'k'k'k*'k*'k*-k*-k-k*it-k-k-k-kitic*’k'k'k'k-k-k‘k**'k*’k*’k'k'k-k-k'k-k'k-k*-k'k-k-k-k*ie-k 


'k'k'k 

INTERNAL 

SUBROUTINE: TI70500 

kkk 

*** 



kkk 

*** 

DESCRIPTION: 

kkk 

*** 



kkk 

*** 

Subroutine to create Task Control Block for specified task. 

kkk 

*** 



kkk 

•kirk 



kkk 

kkk 

NOTES: 


kkk 

kkk 


If an error occurs, the error handling logic specified 

kkk 

kkk 


in the TASK TABLE structure will be executed via a 

kkk 

kkk 


Jump-to-Subroutine call. The caller is responsible for 

kkk 

kkk 


maintaining the stack pointer so the TASK INITIATOR 

kkk 

kkk 


task can commence normal processing with the next 

kkk 

kkk 


TASK TABLE entry. All other registers will be preserved 

kkk 

kkk 


by the TASK INITIATOR task. If the caller has elected 

kkk 

kkk 


to bypass the error handling logic, processing on this 
TASK TABLE entry will terminate, and a return to the 

kkk 

kkk 


kkk 

kkk 


caller will be executed. 

kkk 

kkk 



kkk 

kkk 

REGISTER USAGE {A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 



kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 


kkk 

kkk 

D: 

P P P P P P P P 

kkk 

kkk 

A: 

P P P AR AR AR P P 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

INPUT: 


kkk 

kkk 


A3 = Address where CREATE TCB parameter block can be 

kkk 

kkk 


built. 

kkk 

kkk 



kkk 

kkk 


A4 = Address of TTE to be processed 

kkk 

kkk 


kkk 

kkk 


A5 = TTS start address 

kkk 

kkk 



kkk 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


A3 = Unchanged 

kkk 

kkk 


A4 = Unchanged 

kkk 

kkk 


A5 = Unchanged 

kkk 

kkk 



kkk 

kkk 

CONDITION 

CODES 

kkk 

kkk 



kkk 

kkk 


NOT-EQUAL --> Error occurred processing this TTE 

kkk 

kkk 


kkk 

kkk 


EQUAL --> TTE had TCB created 

kkk 

kkk 



kkk 
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D.3 TI71000 - CALL EHL 


*******************************-k****-k***************************************** 


*** 

INTERNAL 

SUBROUTINE: TI7I000 

kkk 

*** 



kkk 

*** 

DESCRIPTION: 

kkk 

*** 



kkk 

*** 

Subroutine to 

kkk 

*** 


Call the Error Handling Logic (EHL) 

kkk 

*** 


kkk 

*** 

NOTES: 


kkk 

*** 


The caller is responsible for maintaining the stack 

kkk 

*** 


pointer so the TASK INITIATOR task can commence normal 

kkk 

★** 


processing with the next TASK TABLE entry. All other 

kkk 

*** 


registers will be preserved by the TASK INITIATOR task. 

kkk 

ic** 


If the caller has elected to bypass the error handling 

kkk 

*** 


logic, processing on this TASK TABLE entry will 

kkk 

"kirk 


terminate and a return to the caller will be executed. 

kkk 

kkk 



kkk 

kkk 


The user should refer to offset TTSEHLOS for the 

kkk 

kk* 


implementation that will allow the user to bypass the 

kkk 

kkk 


error handling logic 

kkk 

kkk 


kkk 

kkk 

REGISTER USAGE (Alrgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 



kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 


kkk 

kkk 

D: 

ARPPPPPPP 

kkk 

kkk 

A: 

AR P P P P AR P P 

kkk 

*** 



kkk 

kkk 




kkk 

INPUT: 



kkk 



kkk 

kkk 


A5 = TASK TABLE structure start address 

kkk 

kkk 


use 

kkk 

kkk 



kkk 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


A5 = Unchanged 

kkk 

kkk 



kkk 

kkk 

CONDITION 

CODES 

kkk 

kkk 



kkk 

kkk 


N/A 

kkk 

kkk 



kkk 


******************************-k********-lrl!*1i1i********************************** 
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D.4 TI71200 -- GET TASK ID 


****************************************************************************** 


*** 

INTERNAL SUBROUTINE: TI7I200 

kkk 

*** 


kkk 

*** 

DESCRIPTION: 

kkk 

ic** 


kkk 

*** 

Subroutine to get task identification. 

kkk 

*** 

kkk 

icicic 


kkk 

•kirk 

NOTES: 

kkk 

kkk 

N/A 

kkk 

kkk 

kkk 

kkk 

REGISTER USAGE {A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 

kkk 

kkk 

0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 

kkk 

kkk 

D: RPPPPPPP 

kkk 

kkk 

A: R R P AR AR P P P 

kkk 

kkk 


kkk 

kkk 


kkk 

kkk 

INPUT: 

kkk 

kkk 


kkk 

kkk 

A3 = Address where GET TASK identification parameter 

kkk 

kkk 

block can be built 

kkk 

kkk 


kkk 

kkk 

A4 = Address of TASK TABLE entry to be processed 


kkk 

kkk 

kkk 


kkk 

kkk 


kkk 

kkk 

OUTPUT: 

kkk 

kkk 


kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

*** 

kkk 

kkk 

AO/Al = New 8-byte task identification 

kkk 

kkk 

A3 = Unchanged 

kkk 

kkk 

A4 = Unchanged 

kkk 

kkk 

kkk 

kkk 

DO = Results of TRAP request 

kkk 

kkk 

kkk 

kkk 

CONDITION CODES 

kkk 

kkk 


kkk 

kkk 

NOT-EQUAL --> Error occurred trying to get task 

kkk 


identification 

kkk 

kkk 


kkk 

kkk 

EQUAL --> Task identification successfully obtained 

kkk 

kkk 

kkk 


****************************************************************************** 
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D.5 TI71300 - ALLOCATE SECTORS 


****************************************************************************** 


*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 


INTERNAL SUBROUTINE: TI71300 
DESCRIPTION: 

Subroutine to allocate task segments as required. 


*** 

*** 

*** 

*** 

*** 

*** 


NOTES: 


*** 


If an error occurs, the error handling logic specified 
in the TASK TABLE structure will be executed via a 
Jump-to-Subroutine call. The caller is responsible for 
maintaining the stack pointer so the TASK INITIATOR 
task can commence normal processing with the next 
TASK TABLE entry. All other registers will be preserved 
by the TASK INITIATOR task. If the caller has elected 
to bypass the error handling logic, processing on this 
TASK TABLE entry will terminate and a return to the 
caller will be executed. 


*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 


REGISTER USAGE (A)rgument (D)estroyed (P)reserved {R)eturned 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

D: PPPPPPPP 

A: P P P AR AR AR P P 

INPUT: 

A3 = Address where GET SEGMENT parameter block can be 
built. The start address of TDTI’s dynamic 
data area can be used for this address. 

A4 = Address of TASK TABLE entry to be processed 

A5 = TASK TABLE structure start address 
use 

OUTPUT: 

REGISTERS/DATA STRUCTURES 


*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 


A3 = Unchanged 
A4 = Unchanged 
A5 = Unchanged 


*** 

*** 

*** 

*** 


CONDITION CODES 


*** 

*** 


NOT-EQUAL --> Error occurred trying to allocate task *** 

segment *** 

*** 

EQUAL --> All task segments allocated successfully *** 

*** 


****************************************************************************** 
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D.6 TI72800 - START TASK 


****************************************************************************** 


*** 

INTERNAL 

SUBROUTINE: TI72800 

kkk 

*** 



kkk 

*** 

DESCRIPTION: 

kkk 

*** 



kkk 

*** 

Subroutine to start specific task table entry in the TASK 

kkk 



TABLE structure. 

kkk 

*** 



kkk 

*** 



kkk 

*** 

NOTES: 


kkk 

ic** 



kkk 

*** 


PRE-REGISTER initialization for a task can ONLY be 

kkk 

*** 


accomplished by starting a specific task 

kkk 

*** 


from user-specified code. 

*** 

*** 


kkk 

**ic 


If pre-register initialization is NOT selected, then 

*** 

*** 


the register values for a task that is started 

kkk 

*** 


will be zeros. 

kkk 

*ic* 



kkk 

*** 


An attempt by the caller to start a task that has 

kkk 

"kirk 


already been started WILL NOT be construed as 

kkk 

kkk 


an ERROR. The routine will return as if the 

kkk 

kkk 


request was successful . 

kkk 

kkk 


kkk 

kkk 


If an error occurs, the error handling logic specified 

kkk 

kkk 


in the TASK TABLE structure will be executed via a 

kkk 

kkk 


Jump-to-Subroutine call. The caller is responsible for 

kkk 

kkk 


maintaining the stack pointer so the TASK INITIATOR 

kkk 

kkk 


task can commence normal processing when the return via 

kkk 

kkk 


the RTS instruction is executed. All other registers 

kkk 

kkk 


will be preserved by the TASK INITIATOR task. If the 

kkk 

kkk 


caller has elected to bypass the error handling logic. 

kkk 

kkk 


processing to start this task will terminate and the 

kkk 

kkk 


appropriate status condition will be returned. 

kkk 

kkk 


kkk 

kkk 



kkk 

kkk 

REGISTER USAGE (Alrgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 



kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 


kkk 

kkk 

D: 

PPPPPPPP 

kkk 

kkk 

A: 

P P AR AR AR AR P P 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

INPUT: 


kkk 

kkk 



kkk 

kkk 


A2 = If contents of this register equal zero there is 

kkk 

kkk 


no pre-register initialization 

kkk 

kkk 



kkk 

kkk 


ELSE 

kkk 

kkk 



kkk 
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■kicic 


Contents of this address contains the address of 

kkk 

*** 


the pre-register initialization data for 

kkk 

*** 


registers D0-D7 and A0-A6 

kkk 



kkk 

kirk 


A3 = Register contains address where START TASK 

kkk 

kkk 


parameter block can be built 

kkk 

kkk 


*** 

kkk 


A4 = Contains address of the specific TTE 


kkk 


to be started 

*** 

kkk 



*** 

kkk 


A5 = Address of TTS 

*** 

kkk 



*** 

kkk 



kkk 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

*** 



kkk 

kkk 


A2 = Unchanged 

kkk 

kkk 



kkk 

kkk 


A3 = Unchanged 

kkk 

kkk 


kkk 

kkk 


A4 = Unchanged 

kkk 

kkk 


kkk 

kkk 


A5 = Unchanged 

kkk 

kkk 


kkk 

kkk 



kkk 

kkk 

CONDITION 

CODES 

kkk 

kkk 



kkk 

kkk 


ZERO --> Task was started successfully 

kkk 

kkk 


kkk 

kkk 


NOT-ZERO --> Error encountered trying to start task 

kkk 

kkk 


Potential errors are 

kkk 

kkk 


Unable to get task identification 

kkk 

kkk 


Unable to start task 

kkk 

kkk 



kkk 


****************************************************************************** 
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THIS PAGE INTENTIONALLY LEFT BLANK. 
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APPENDIX E 
ERROR INDEX VALUE 


E.l DESCRIPTION 

When an error is encountered by the Table Driven Task Initiator (TDTI) task, 
the user-specified Error Handling Logic (EHL), if it exists, is executed via a 
Jump-to-Subroutine (JSR) call. To aid in the debugging process, the TDTI task 
will place on the stack an Errpr Index Value (EIV). This EIV will be the 
longword immediately following the return address on the stack. This EIV, 
when applied to the EIV table, will identify for the user the type of error 
encountered and the approximate location in the TDTI task where the error 
occurred. The TDTI task will be responsible for removal of the EIV from the 
stack in the event the user elects to return from the EHL. 

-I 1- 

I Return address from| 

I EHL I 

^ \. 

I Error Index Value | 

I I 

+ + 


E.2 ERROR INDEX VALUE TABLE 


The EIV table has the following EIV code structure: 

EIV RANGE DESCRIPTION 

$0000 - $1FFF TDTI Errors 


EIVSOOlO 


EIVS0020 

contains the TT structure, and user- 
specified code or EHL that may exist, 
so it can process it. An error will 
occur if this segment cannot be 
obtained. 


General location: TI20000 mainline code. 

Problem: After obtaining a data segment, TDTI 
zeros it out. An error will occur if 
the number of bytes to zero out is zero 
or negative. 

General location: TI20000 mainline code. 

Problem: TDTI tries to obtain the segment which 
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EIV$0030 

EIV$0040 

EIV$1010 

EIV$1020 

EIV$1030 

EIV$1040 

EIV$1050 

EIV$1054 

EIV$1060 

EIV$1070 


General location: TI60000 routine. 

Problem: The TDTI task will attempt to find a TT 
entry based on an index value. An error 
will occur if the TT entry cannot be 
found . 

General location: TI72800 routine. 

Problem: Prior to starting a task, the work area 

set aside for starting the task is 
initialized to zeros. An error will 
occur if the number of bytes to clear 
is zero or negative. 

General location: TI70500 routine. 

Problem: An error occurred when the create TCB 
request was made. 

General location: TI71300 routine. 

Problem; An error occurred because the number of 
segments to allocate for the task was 
less than one. 

General location: TI71300 routine. 

Problem: An error occurred trying to obtain the 
task identification. 

General location: TI71300 routine. 

Problem: An error occurred trying to allocate a 
segment for the task. 

General location: TI71300 routine. 

Problem: An error occurred trying to declare a 

segment shareable. 

General location: TI71300 routine. 

Problem: An error occurred trying to transfer a 

segment to the target task. 

General location: TI72800 routine. 

Problem: An error occurred trying to obtain the 

task identification. 

General location: TI72800 routine. 

Problem: An error occurred trying to start the 
task. 
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APPENDIX F 

INTEGRATING A PASCAL TASK INTO A TDTI SYSTEM 


F.l PROBLEM ASSOCIATED WITH PASCAL TASKS IN A TDTI SYSTEM 

The example presented in the manual describes how to integrate an assembly 
language task into the Table-Driven Task Initiator (TDTI) system. The 
technique used cannot be directly applied to tasks written in Pascal, for two 
reasons. First, the Pascal runtime initializer expects logical units 5 and 6 
to be assigned to a standard input and standard output device, respectively, 
when the task is first started. Second, the length of the command line is 
normally passed in a register at startup time. In the case of a TDTI system, 
there is no command line. 

The above functions are normally performed by the VERSAdos session manager 
when the Pascal task is started in the normal full VERSAdos environment. 
Since tasks that TDTI starts are already present in memory and not loaded by 
the session manager, it is necessary to provide for the passing of logical 
units 5 and 6 and for the correct handling of a nonexistent command line in a 
different way. One technique for doing this is described below. The 
technique has been applied to Pascal tasks, but it could also apply to tasks 
written in other high level languages, or even to tasks written in assembly 
language if desired. 


F.2 RECOMMENDED SOLUTION TO PROBLEM 

The recommended solution to the above problem is to provide code to pass 
logical units 5 and 6, and to indicate an empty command line to the task being 
started. This code will be pointed to by the "non-standard startup" cell in 
the associated task entry of TDTI’s task startup table. In addition to these 
functions, the code can initialize the registers of the task being started. 
This code will have to perform all of the other functions associated with task 
startup that the TDTI task would perform in the "standard" case. This code 
consists of a small user-written module and a supplied subroutine module that 
will perform most of the work. 

The non-standard startup module has been reproduced in a later section of this 
supplement. The following diagram shows the structural relationships between 
TDTI and the startup module. 
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Task table TDTI task 


Non-standard | | 

startup cell | j< 

>1 I 

I Entry A | | | | 


I Entry B 


I Entry C 


"Non-standard startup code" 
BSR-> 


<--RTS I 

I 

V 


I Small I BSR--> | Non- | 

I user- |< >1 standard j 

I written | <--RTS j startup j 

I interface! I module j 


The user-written interface indicated above is very simple. It is illustrated 
below: 


START 

* 

* 

XREF 

MOVE.L 

NSSUPASC 

#CN11,A1 

Indicate the device mnemonic 
desired for the assignment of 
logical units 5 and 6. 


BSR 

NSSUPASC 

Call the non-standard startup 
module. 

* 

IF <NE> 
BRA.S 

ENOI 

THEN.S 

* 

Here we hang on a branch if there 
was an error in the startup. 


RTS 


Return to TDTI. 


Note that there is no mention of command line in the above routine. This is 
because the non-standard startup module will indicate to the Pascal task that 
the command line length was 0 (no command line). If the user had desired to 
initialize some register values and have them passed to the task, that could 
have been done in the above module. The registers that can be passed are AD- 
AS, and D0-D5. Note that D6 and D7 are set by the startup module to contain 
command line length (0) and logical unit bit mask ($61) respectively. 
Registers A4-A6 are reserved and cannot be used to pass information. The 
terminal identification must be passed in register Al. What is presented 
above, however, is the minimum necessary to start a Pascal task. 
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F.3 PASCAL TDTI SYSTEM EXAMPLE 


F.3.1 System Description 

The TDTI demonstration system is a VM04 which contains RMS, a serial 
input/output driver, the VM22 driver, the Intelligent Peripheral Controller 
(IPC) driver, the TRAP #3 server (File Handling Services (FHS)), the I/O 
subsystem {Input/Output Services (lOS)), and TDTI. Applications include two 
Pascal tasks, non-standard user-written code for each task, the non-standard 
startup routine, and the task table created via the TDTI support utility 
TTGEN. 

The Pascal tasks, which use the shareable Pascal runtime library, illustrate 
the use of the library by de-assigning the standard input/output and then re- 
assigning them. After this is done, each task goes into an infinite loop 
displaying a message to "CNH", the terminal chosen for this example. 


F.3. 2 Memory Map 

The INITDAT module, which must be modified to reflect the user’s partitioning, 
contains three partitions: 

a. RAM partition 0, which RMS will use to obtain RAM for system as well as 
user requirements. 

b. RAM partition 2, which is defined to contain the read/write segment 
associated with the Pascal task. 

c. ROM partition to contain the following: 

. Pascal task code and shareable runtime library 

. Task table to be processed by TDTI 

. Error handling logic referenced by the task table 

. Non-standard user-written logic referenced by the task table 

. Non-standard startup routine called from the user-written non- 
standard code 
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00000 + + ---+ 

I I I 

I RAM for TDTI system usage; | |---> RAM 

I VERSAdos is resident here | | Partition 

I I I 0 

EDOOO + + ---+ 

I Read/write segment for | | 

I Pascal task A (SEG2) | |---> RAM 

EE800 + + I Partition 

I Read/write segment for | | 2 

I Pascal task B (SEG2) | | 

FOOOO + + ---+ 

1 Code segment for Pascal | I 

I task A (SEGl) | |---> ROM 

FODOO + + I Partition 

I Code segment for Pascal | | 

I task B (SEGl) I I 

FIBOO + + I 

I Error handling logic | | 

FICOO + - + I 

I Non-standard startup | | 

I routine | j 

F2000 + + I 

I Non-standard user-written | | 

I code for Pascal task A | | 

F2200 + + I 

I Non-standard user-written | | 

I code for Pascal task B | I 

F4000 + + I 

I TDTI task table | I 

I I I 

F6000 + - + I 

I PASCAL shareable runtime | | 

I library (RRTL) 1 | 

FFOOO + + I 

I Available for use | | 

I I I 

FFFFF + + ---+ 
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To aid in explaining the memory map shown above, the link files for the Pascal 
tasks are shown below: 


TASK A 


=/IFC \1 

=ARG TASKA.LL 
=/ENDIF 
=/* 

=LINK ,ATASK.L0,\1;HAMIXS 
TASK ATAS,’$0010 
PRIORITIES $42,$7F 
ATTRIBUTES P 
SEG SEG1(R):0,9 $F0000 
SEG SEG2;15 $ED000 

SEG RRTL(GR):8 $F6000 
IN 9998.RRTL.RTLINIT.ro 
IN &. TASKA.ro 

IN 9998.RRTL.RRTLACCS.ro 
IN 9998.RRTL.PRTL.ro 
IN 9998. RRTL.PLJSR.ro 
IN 9998.RRTL.RFINIT.ro 
IN 9998.RRTL.RTRAPS.ro 
IN 9998.RRTL.RPSCALIB.ro 
LIB O.&. PDOLRLIB.ro 
END 

=/* 

=END 


TASK B 


=/IFC \1 

=ARG TASKB.LL 
=/ENDIF 
=/* 

=LINK ,BTASK.L0,\1;HAMIXS 
TASK BTAS,’$0010 
PRIORITIES $42,$7F 
ATTRIBUTES P 
SEG SEG1(R):0,9 $FODOO 
SEG SEG2:15 $EE800 

SEG RRTL(GR):8 $F6000 
IN 9998.RRTL.RTLINIT.ro 
IN &. TASKB.ro 

IN 9998.RRTL.RRTLACCS.ro 
IN 9998.RRTL.PRTL.ro 
IN 9998.RRTL.PLJSR.ro 
IN 9998.RRTL.RFINIT.ro 
IN 9998.RRTL.RTRAPS.ro 
IN 9998.RRTL.RPSCALIB.ro 
LIB O.&. PDOLRLIB.ro 
END 

=/* 

=END 


Note that SEG2, which is a read/write segment, has been removed from the ROM 
partition and placed in partition 2. Partition 2 has been defined with a 
memory type different than partition 1 so that RMS will not allocate that 
memory for the system/user memory requirements. Segments SEGl and RRTL are 
read-only segments that have been placed in the ROM partition. SEGl 
represents the Pascal code for each respective task while RRTL is the 
shareable runtime library that is common to both Pascal tasks. 

The task table, non-standard user-written code, non-standard startup routine, 
and error handling logic reside in the ROM partition at user-chosen addresses 
discussed in section S.3.4. 
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F.3.3 Task Table Generation 

The TDTI support utility, TTGEN, will create the major part of the task table 
required for the TDTI task. 

The load modules created by the Pascal link files shown above were used as 
input to the TTGEN utility to create the task table. Note that in addition to 
specifying the start address of each segment, the linker commands ’TASK’ and 
’PRIORITIES’ are used to define the taskname, session number, and priorities. 
This information, if supplied at link time, will automatically be extracted 
from the Loader Information Block and placed in the task table entry by TTGEN. 

The modifications that were made to the task table created by the TTGEN 
utility were as follows; 

. Defining the external references to the mnemonics defined. 

. Defining the offset mnemonic to the non-standard user-written routine 
for each Pascal task. 

. Setting a bit (bit 10) in the segment attributes of SEGl and RRTL to 
indicate that they reside in a ROM segment. 

. Adding an ’END’ statement. 

The results of running the TTGEN utility with the above modifications follow: 


PAGE 

* Table Driven Task Initiator (TDTI) startup table. 

* Created with TTGEN 

SECTION 4 
XREF TTSEHL 
XREF NSSUTEOA 
XREF NSSUTEOB 

* ORG not def 


* 

* 

* 

TASK TABLE 

HEADER 



DC.L 

’!HDR’ 

Header ID. 


* 

DC.L 

TTSEHL-* 

Address offset of error handling routin 
Zero means no error handling routine. 


DC.L 

HEDR_END-* 

Address offset to 

first table entry. 

HEDR END 
* 

EQU 

* 



* 

* 

E N 

D OF TASK 

TABLE HEA 

D E R 


(NOTE) 

(NOTE) 

(NOTE) 


82 


MICROSYSTEMS 




@) MOTOROLA 


APPENDIX F 


PAGE 

* * 

* TASK ENTRY TEOA * 

* * 


DC.L ’TEOA’ 

DC.L TEOAJND-* 

DC.L NSSUTEOA-* 

Processing order value 
DC.B 0 
DC.B ’R’ 

DC.L ’ATAS’ 

DC.L ’0010’ 

DC.W %0000000000000000 
DC.L $0 
DC.L $00000000 
DC.B $42 
DC.B $7F 

DC.W %0000100000000000 
DC.L $000F0000 
DC.W 0 
DC.W 3 


Task entry ID 
Offset to next entry 

Offset to special non-standard processing 
(NOTE) DC.W 0 

Reserved 

State (’D’ “dormant, ’R’=ready) 

Task name 

’ ’ Task session number 

TCB directive options 
Monitor task name 

’ ’ Monitor session number 

Task initial priority 
Task limit priority 
Task attributes 
Task start address 
User-generated task ID 
Number of segments for task 


Segment entry for task ’TEOA’, segment ’SEG2’ 


DC.W 

DC.W 

DC.L 

DC.L 

DC.L 


%0000000100000000 

%0000000000000000 

’SEG2’ 

$000ED000 

$00001400 


Segment directive options 
Segment attributes 
Segment name 

Start address of segment 
Length of segment 


Segment entry for task ’TEOA’, segment ’SEGl’ 


DC.W %0000000100000000 
DC.W %0I00010000000000 
DC.L ’SEGl’ 

DC.L $000F0000 
DC.L $00000D00 


Segment directive options 
Segment attributes (NOTE) 
Segment name 

Start address of segment 
Length of segment 


■k 

*_ 

* 


Segment entry for task ’TEOA’, segment ’RRTL’ 


DC.W 

DC.W 

DC.L 

DC.L 

DC.L 

TE0A_END EQU 


%0000000100000000 

%0101010000000000 

’RRTL’ 

$000F6000 

$00008F00 


Segment directive options 
Segment attributes (NOTE) 
Segment name 

Start address of segment 
Length of segment 


END OF ENTRY FOR 


TEOA 
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PAGE 

* * 

* TASK ENTRY TEOB * 

* * 


* 


DC.L ’TEOB’ 

DC.L 0 

DC.L NSSUTEOB-* 

Processing order value 
DC.B 0 
DC.B ’R’ 

DC.L ’BTAS’ 

DC.L ’0010’ 

DC.W %0000000000000000 
DC.L $0 
DC.L $00000000 
DC.B $42 
DC.B $7F 

DC.W %0000 100000000000 
DC.L SOOOFODOO 
DC.W 0 
DC.W 3 


Task entry ID 
Offset to next entry 

Offset to special non-standard processing 
(NOTE) DC.W 0 


Reserved 

State (’D’=dormant, ’R’=ready) 
Task name 

’ ’ Task session number 

TCB directive options 
Monitor task name 

’ ’ Monitor session number 

Task initial priority 
Task limit priority 
Task attributes 
Task start address 
User-generated task ID 
Number of segments for task 


Segment entry for task ’TEOB’, segment ’SEG2’ 

DC.W 
DC.W 
DC.L 
DC.L 
DC.L 


Segment entry for task ’TEOB’, segment ’SEGl’ 

DC.W %0000000100000000 Segment directive options 

DC.W %0100010000000000 Segment attributes (NOTE) 
DC.L ’SEGl’ Segment name 

DC.L SOOOFODOO Start address of segment 

DC.L $00000D00 Length of segment 


%0000000100000000 Segment directive options 
%0000000000000000 Segment attributes 
’SEG2’ Segment name 

$000EE800 Start address of segment 

$00001400 Length of segment 


1c 

* Segment entry for task ’TEOB’, segment ’RRTL’ 

* 



DC.W 

%0000000100000000 

Segment directive options 


DC.W 

%0101010000000000 

Segment attributes (NOTE) 


DC.L 

’RRTL’ 

Segment name 


DC.L 

S000F6000 

Start address of segment 


DC.L 

S00008F00 

Length of segment 

TE0B_END 
* 

EQU 

* 


* 

* 


END OF ENTRY 

FOR -- TEOB 
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* * 

* it 

* ENDOFTASKTABLE * 

* * 

* Have a nice day ! * 

* * 

* * 

END 


NOTE 


Lines flagged with (NOTE) have been modified. 


F.3.4 SYSGEN Command File 

The integration of the task table, non-standard code, and error handling logic 
into the ROM partition was done via a SYSGEN. The following SYSGEN command 
file processes, respectively, these items: 

. Error handling logic 
. Non-standard startup routine 
. Non-standard user-written code for each task 
. Task table 

Note that the SYSGEN ’EXCLUDE’ command is used to process the non-standard 
startup routine as well as the non-standard user-written code for each Pascal 
task. The link will include the segment specified so that external references 
can be satisfied, but the SYSGEN ’EXCLUDE’ command will remove them from the 
resultant load module. 

The following addresses, excluding those referencing TDTI, can be related to 
the memory map in section F.3.2. 

it 

* TTSUCEHL.CD 

* 

* This command file is used to accumulate the following modules 

* 

* Task Table Required 

* Non-standard user code Optional 

* Error handling logic Optional 

* 

* The addresses should reflect those to be processed by the 

* Table Driven Task Initiator task (TDTI). 

* 

* The values defined in this file will be used by the 

* VERSAdos SYSGEN and the task table SYSGEN 

* 

* 

* Start address of TDTI task 

* 

TDTISTRT = $DE00 
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* The following flags are defined as follows 

* 


* Non-zero 

* Zero 

* 

FLAGEHL = 

FLAGUSC = 


--> The information exists 

--> The information does not exist 

1 Flag for error handling logic 

1 Flag for user-specified code 


IFNE \FLAGEHL 

|\||5Q *************************************************** 

MSG * * 

MSG * Process the Error Handling Logic * 

MSG * * 

MSG *************************************************** 


* 

* TTSEHL.CI 

* 

* This command file has been built to create a task table 

* error handling logic module. 

* 

* STARTEHL = Start address of the error handling logic. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 


PC = $F1B00 


STARTEHL = 

* 

PROCESS 

&.TTSEHL.L0 

SUBS 

&.TTSEHL.LG 

LINK 

&.TTSEHL.LG 

END 

TTSEHL 

* 


* 


* 


ENDC 



IFNE 

\FLAGUSC 


MSG 

*************************************************** 

MSG 

* 

* 

MSG 

* Process User-Specified Code 

* 

MSG 

* 

* 

MSG 

*************************************************** 
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* 

* TDTI.NSSUPASC.CI 

* 

* This command file has been built to create the non-standard startup 

* code routine which can be used with the Table Driven Task Initiator. 

* 

* NSSURSA = Start address for the non-standard startup routine. This 

* address is in the range of AREASA to AREAEA defined in 

* module TDTI.CI 

* 

* 


PC = $F1C00 
NSSURSA = * 


PROCESS TDTI.NSSUPASC.LO 
EXCLUDE TDTI 
SUBS TDTI.NSSUPAS.LG 

LINK TDTI.NSSUPAS.LG 

END NSSUPASC 

* 


* 


* 

* NSSU.TASKA.CI 

* 

* This command file has been built to create user-written non-standard 

* module for use with the Table Driven Task Initiator task. 

* 

* NSSUTASA = Start address of the user-specified code. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 

* 

* 


PC = $F2000 


NSSUTASA = 

* 

PROCESS 

NSSU.TASKA.LO 

EXCLUDE 

TDTI 

EXCLUDE 

NSPL 

SUBS 

NSSU.TASKA.LG 

LINK 

NSSU.TASKA.LG 

END 

NSSUTSKA 

* 


* 


* 
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* 

* NSSU. TASKS. Cl 

* 

* This command file has been built to create user-written non-standard 

* module for use with the Table Driven Task Initiator task. 

* 

* NSSUTBSA = Start address of the user-specified code. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 

* 

* 


PC = $F2200 
NSSUTBSA = * 

PROCESS NSSU. TASKS. LO 

EXCLUDE TDTI 

EXCLUDE NSPL 

SUBS NSSU. TASKS. LG 

LINK NSSU. TASKS. LG 

END NSSUTSKB 


* 


ENDC 


MSG *************************************************** 

MSG * * 

MSG * Process the Task Table * 

MSG * * 

*************************************************** 


* 

* &.TTS.CI 

* 

* This command file has been built to create the task table 

* module for use with the Table Driven Task Initiator task. 

* 

* STARTTTS = Start address of the Task Table. This address 

* is in the range of AREASA to AREAEA defined in module 

* TDTI.CI 

* 


PC = $F4000 

STARTTTS = * 

PROCESS &.TTS.L0 

SUBS &.TTS.LG 

LINK &.TTS.LG 
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END 

* 

* 

* 


END SYSGEN 


F.3.5 Sample Link Files 

Sample link files used by the SYSGEN command file for the non-standard start- 
up routine, non-standard user-written code, and task table are as follows: 

a. Non-standard startup routine: 


=/* TDTI.NSSUPASC.LG 

=/* 

=/* Link file to link the non-standard startup routine 

=/* 

=L INK , TDTI . NSSUPASC . LO , TDT I . NSSUPASC . LL ; HAMIX 
SEG TDTI:0 $DE00 
SEG NSPL:13 $F1C00 

IN ttssa.tdti.ro 

IN &.TDTI.R0 

IN tdti.nssupasc.ro 

END 

=END 


b. Non-standard user-written code for a task: 


=/* NSSU.TASKA.LG 

=/* 

=/* Link file to link non-standard code for this task entry 

=/* 

=LINK ,NSSU.TASKA.LO,NSSU.TASKA.LL;HAMIX 
SEG TDTI:0 $DE00 
SEG NSPL:13 $F1C00 
SEG NSPA:2 $F2000 

IN ttssa.tdti.ro 

IN &.TDTI.R0 

IN tdti.nssupasc.ro 
IN nssu.taska.ro 

END 

=END 
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c. Task table: 

The linker ’DEFINE’ commands were used to identify the start address of the 
error handling logic (TTSEHL), the start address of task ’A’ (NSSUTEOA) and 
task ’B’ (NSSUTEOB) non-standard user-written code, respectively. 


=/* 

=/* TTS.LG 
=/* 

=/* Link chainfile to create TTS.LO 
=/* 

=LINK ,&.TTS.LO,TTS.LL;AHMIX 
DEFINE TTSEHL, $F1B00 
DEFINE NSSUTEOA, $F2000 
DEFINE NSSUTEOB, $F2200 
SEG TTS0:4 $F4000 
INPUT &.TTS.RO 
END 

=/* 

=END 
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F.3.6 Listing of Non-Standard Startup Routine Code 


* 

* 

* 

•k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 


User- written code 

I 

I 

I Input requirements 

I 

I 

Create/start task 
in VERSAdos 
environment 




Assign standard terminal Create task 

INPUT and OUTPUT 


I I I 

Assign LUN 5 Assign LUN 6 Transfer LUN 


I 

Start task 


Transfer LUN 5 Transfer LUN 6 
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4r 

* 

* 

* 

•k 

* 

* 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 


PAGE 

TDTLNSSUPASC.SA 

This routine is a non-standard startup routine which executes 
as a subroutine to the TDTI task via the non-standard user-written 
code. 

This routine is called to create/start a task by performing the 
following functions: 

0 Assign to TDTI, for the user-specified terminal 
identification, logical unit 5 for INPUT and logical 
unit 6 for OUTPUT 

0 Create the Task Control Block (TCB) for the task 
0 Allocate the task’s required segments 
0 Pass logical units 5 and 6 to the task to being processed 
0 Start the task if requested 
Entry requirements 

A1 « Initial terminal identification (device mnemonic, 
i.e, CNOO) the task wants to be assigned to INPUT 
and OUTPUT, respectively logical units 5 and 6 
A4 = Address of task table entry to process 
A5 = Address of task table header 

Registers A4 and A5 are already established upon entry to the 
user-written code; consequently they need only be passed to this 
routine. 

Exit status 

All registers are preserved EXCEPT register DO. 


Exit conditions 

Non-zero --> Error occurred 

DO * Error code in following format 

+ + + 

I NSSUPASC INTERNAL | RMS RETURNED CODE | 

I ERROR CODE | IF APPLICABLE | 

I I ELSE ZERO I 

+ + + 
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* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


NSSUPASC INTERNAL 
ERROR COOES 

1 Error assigning LUN 5 

2 Error assigning LUN 6 

3 Error creating Task Control Block 

4 Error allocating task segments 

5 Error obtaining task identification 

6 Error changing LUN 5 

7 Error changing LUN 6 

8 Error starting task 

Zero --> Routine completed successfully 
DO = ZERO 


EXTERNAL DEFINITIONS 

XDEF NSSUPASC 

XDEF NSPTASKP 


* 

* 

* 

4r 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


EXTERNAL REFERENCES 

The method by which the external references, listed below, are 
satisfied will depend upon the linking mechanism the user selects. 


The most common means of satisfying the references are 

1. Via a SYSGEN, to INCLUDE the TDTI segment, which contains 
the corresponding external definitions, to satisfy the 
external references but EXCLUDE it from the actual linking 
of this module, where INCLUDE and EXCLUDE are SYSGEN 
commands. 

2. Link this module, using the link DEFINE commands if the user 
knows where each external reference resides. 



TDTI routine references 

XREF 

TI70200 

Character fill a specified area 

XREF 

TI70500 

Create Task Control Block 

XREF 

TI71200 

Get task identification 

XREF 

TI71300 

Allocate segments to a task 

XREF 

TI72800 

Start task 

PAGE 
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* 


* 

INCLUDE 

TEMPLATE. TDTITTS.AI 

* 

INCLUDE 

9995.&.EXE.EQ 

ie 

INCLUDE 

9995.&.IOE.EQ 

■k 

INCLUDE 

9995.&.NIO.EQ 

* 

INCLUDE 

9995.&.FME.EQ 

* 

* 

INCLUDE 

NOLIST 

9995.&.FMI.EQ 


INCLUDE 

TEMPLATE. TDTITTS.AI 


INCLUDE 

9995.&.EXE.EQ 


INCLUDE 

9995.&.IOE.EQ 


INCLUDE 

9995.&.NIO.EQ 


INCLUDE 

9995.&.FME.EQ 


INCLUDE 

LIST 

PAGE 

9995.&.FMI.EQ 


* 


* 

k 

MACROS 



AJDO 

MACRO 




SWAP 

DO 


* 

MOVE.W 

D5,DO 

Exchange high order and low order words 

* 

SWAP 

DO 

Establish the NSSUPASC internal code 

k 



Establish DO in error exit format 

k 

k 


The exit 

format for ’DO’ is: 

k 



+ + 

k 



1 NSSUPASC INTERNAL | RMS RETURNED CODE 

k 



1 ERROR CODE | IF APPLICABLE 

k 



1 1 ELSE ZERO 

k 



+ + 

k 

ENDM 



ILLINST 

MACRO 




DC.W 

$4AFC 


k 

ENDM 


Illegal instruction 


PAGE 
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* 

★ 

* 

* 

* 

* 

* 

* 

■k 

* 

•k 

k 


Save registers 

Assign terminal device, for standard INPUT and OUTPUT, 
to this routine (ASTDLUN) 

IF assignment error 

Establish error exit status 
Restore saved registers 
Return to caller 
Restore saved registers 

Create the task for general VERSAdos environment (NSPTASKP) 
Return to caller 



SECTION 

13 


PBA 

EQU 

* 

Program Base Address for this routine 

NSSUPASC: 

MOVE.L 

#$61, D7 



CLR.L 

D6 


* 



Force these registers to conform to the 

k 



documentation stated for the Session Control 

k 



START command discussed in the VERSAdos 

k 



System Facilities manual 

k 



D7 = Logical unit assignments for LUN 5 and 

k 



and zero for device assignments 

k 



D6 = The command line length must be zero 


MOVEM.L 

D0-D7/A0-A6,-(A7) 

k 



Save the registers 


LEA 

PBA(PC), 

M 

k 



A2 = Program Base Address for this routine 

k 



A2 will maintain this value throughout 

k 

BSR.S 

ASTDLUN 

this routine 

k 



Assign standard terminal device LUN 5 and 6 

k 

IF <NE> 

THEN.S 

for the terminal specified by the user 


* 

* 


* 


* 


MOVE.L 

MOVEM.L 

RTS 


D0,(A7) 

Establish routine exit conditions and register DO 
(A7)+,D0-D7/A0-A6 

Restore registers that were saved 

Return to caller 


ENDI 

MOVEM.L (A7)+,D0-D7/A0-A6 

Restore registers that were saved 
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BSR.S 

NSPTASKP 

* 


Create the task for the general VERSAdos 

* 

RTS 

environment 

* 


Return to caller 


PAGE 


****************************************************************************** 


*** 

INTERNAL 

SUBROUTINE: ASTDLUN 

kkk 

*** 



kkk 

*** 

DESCRIPTION: 

kkk 

*** 



kkk 

*** 

Subroutine to 

kkk 

■kicit 


Establish LUN 5 as the INPUT device 

kkk 

*** 


Establish LUN 6 as the OUTPUT device 

kkk 

■kkie 



kkk 

*** 

NOTES: 


kkk 

**ic 


N/A 

kkk 

iekk 


kkk 

k-kk 

REGISTER USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 



kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

*** 

kkk 


*** 

kkk 

D: 

DRPPPPPPP 

*** 

kkk 

A: 

D AR AR P AR AR P P 

kkk 

*** 



kkk 

*** 



kkk 

kkk 

INPUT: 


kkk 

kkk 



kkk 

kkk 



kkk 

kkk 


A1 = Initial terminal identification the task 

kkk 

kkk 


wants to be assigned to INPUT and OUTPUT, 

kkk 

kkk 


respectively logical units 5 and 6. 

kkk 

kkk 


A2 = Program Base Address for this routine 

kkk 

kkk 


A4 = Address of TASK TABLE entry to be processed 

kkk 

kkk 


A5 = Address of TASK TABLE header 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


A1 = Unchanged 

kkk 

kkk 


A2 = Unchanged 

kkk 

kkk 


A4 = Unchanged 

kkk 

kkk 


A5 = Unchanged 

kkk 

kkk 


kkk 

kkk 


DO = See CONDITION CODES below for definition 

kkk 

kkk 



kkk 
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■kicic 

CONDITION CODES 


*** 

kick 



kkk 

kkk 

Not Equal --> Error occurred trying assign LUN 


kkk 

kkk 


kkk 

kkk 

DO = Error code in following format 


kkk 

kkk 


kkk 

kkk 



kkk 




kkk 

1 NSSUPASC INTERNAL | RMS RETURNED CODE 

1 

kkk 

kkk 

1 ERROR CODE | IF APPLICABLE 

1 

kkk 

kkk 

1 1 ELSE ZERO 

1 

kkk 

kkk 



kkk 




kkk 



kkk 

kkk 



kkk 

kkk 

Equal --> LUN assignments were successful 


kkk 

kkk 


kkk 

kkk 

DO = ZERO 


kkk 

kkk 



kkk 

****************************************************************************** 

*** 



kkk 

kkk 

Establish routine input for LUN 5 


kkk 

kkk 

Assign LUN 5 for INPUT (NSPLALUN) 


kkk 

kkk 

IF error in LUN assignment 


kkk 

kkk 

Adjust format of error in DO to meet routine exit format 


kkk 

kkk 

Establish routine exit conditions 


kkk 

kkk 

Return to caller 


kkk 

kkk 

Establish routine input for LUN 6 


kkk 

*** 

Assign LUN 6 for OUTPUT (NSPLALUN) 


kkk 

*** 

IF error in LUN assignment 


*** 

kkk 

Adjust format of error in DO to meet routine exit format 


*** 

kkk 

Establish routine exit conditions 


*** 

kkk 

Return to caller 


kkk 

kkk 

Return to caller 


kkk 

kkk 



kkk 


****************************************************************************** 


ASTDLUN: 


* 

* 

* 


* 


* 


* 

* 

* 

* 


MOVE.L #5,D1 LUN 

MOVE.L #F0PPR,D2 Assign options 

A1 = Contains the terminal ID to assign LUN to 
D1 = Contains LUN for INPUT assignment 
D2 = Contains options for LUN assignment (PR) 
Routine input requirements for NSPLALUN 

BSR.S NSPLALUN 


Assign LUN 5 for INPUT 

IF <NE> THEN.S 


MOVE.L #1,D5 

D5 = NSSUPASC internal error code 

Error trying to assign logical unit 5 
DO = Results of trap assignment call 

Routine input requirements for NSPLAJDO 
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AJDO 



k 



Adjust register DO to reflect the output format 

k 

TST. 

L DO 

for this routine 

k 

RTS 


Establish routine exit conditions 

k 

ENDI 


Return to caller 


MOVE.L 

#6,D1 

LUN 


MOVE.L 

#F0PPW,D2 

Assign options 

A1 = Contains the terminal ID to assign LUN to 

k 



D1 = Contains LUN for OUTPUT assignment 

k 



D2 = Contains options for LUN assignment (PW) 

k 



Routine input requirements for NSPLALUN 


BSR.S NSPLALUN 

Assign LUN 6 for OUTPUT 

IF <NE> THEN.S 


* 

* 

* 

* 

* 

* 


* 


* 


MOVE.L #2,D5 

D5 = NSSUPASC internal error code 

Error trying to assign logical unit 6 
DO = Results of trap assignment call 

Routine input requirements for NSPLAJDO 

AJDO 

Adjust register DO to reflect the output format 
for this routine 

TST.L DO 

Establish routine exit conditions 


RTS 

ENDI 


Return to caller 


RTS 


PAGE 


■k'k'k'k’kit'k'k'kit-kitic’kicic'kit'k'k'k’k'k-k'kit’kit’kit’k'kit'k'k’k'kit'kit'kit'kit’k'kit'k'k'kititit’kit'kit'kic'kit-kicic'k-k’k’k’k-k’k’k'k-k-kirk'k 

*** INTERNAL SUBROUTINE: NSPLALUN *** 


ieic-k 

*** 

*** 

*** 

*** 

*** 


DESCRIPTION: 

Subroutine to 

Assign the specified device to the specified LUN 


NOTES: 


N/A 


*** 

-kirk 

kkk 

*** 

•kkk 

kkk 

kkk 

kkk 
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*** 

REGISTER USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

irk* 


kkk 

*k* 

0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

*k* 

*** 

*** 

*k* 

D; DR AR AR P P P P P 

kkk 

*** 

A: PARPPPPPP 

*** 

*k* 


*** 

kkk 


*** 

*** 

INPUT: 

*** 

kkk 


*** 

kkk 


kkk 

kkk 

D1 = Contains the LUN to be assigned 

kkk 

kkk 

D2 = Contains the options for the assignment request 

kkk 

kkk 

A1 = Contains the terminal ID to assign to 

kkk 

kkk 

A2 = Program Base Address for this routine 

kkk 

kkk 

kkk 

kkk 


*** 

kkk 

OUTPUT: 

kkk 

kkk 


*** 

kkk 

REGISTERS/DATA STRUCTURES 

*** 

kkk 


*** 

kkk 

DO = Status of trap call to assign LUN 

*** 

kkk 

DI = Unchanged 

*k* 

kkk 

D2 = Unchanged 

*** 

kkk 

A1 = Unchanged 

*** 

kkk 

A2 = Unchanged 

*** 

*** 


*** 

kkk 

CONDITION CODES 

*** 

kkk 


*** 

kkk 

Not Equal --> Error occurred trying assign LUN 

*** 

kkk 

kkk 

kkk 

DO = Status of trap call to assign LUN 

*** 

kkk 

kkk 

kkk 


*** 

kkk 

Equal --> LUN assignments were successful 

*** 

kkk 

*** 

kkk 

DO = ZERO 

*** 

kkk 


*** 

****************************************************************************** 

*** 


*** 

*** 

Save registers 

*** 

*** 

Put assign parameter block on stack 

*** 

*k* 

Establish register input to TI70200 (AO, DO) 

*** 

*** 

Clear the assign parameter block 

*** 

*** 

*** 

kkk 

IF an error occurs on the parameter block clear 

*** 

kkk 

Execute an illegal instruction as this should never occur 

*** 

*** 

Build the parameter block on the stack 

*** 

*** 

Initiate the assign call 

*** 

*** 

Remove the parameter block from the stack 

*** 

kkk 

Restore saved registers 

*** 

*** 

Establish routine exit conditions 

*** 

kkk 


*** 


h***************************************************************************** 
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FHSBLN EQU $28 Assign LUN parameter block size 


NSPLALUN 

MOVEM.L 

A0/A6,-(A7) 

★ 


Save register 


SUB.L 

#FHSBLN,A7 

* 


Adjust stack with enough space for parameter 

* 


block to assign the terminal to a LUN 


MOVE.L 

A7,A0 

* 


AO = Starting address of parameter block 


MOVE.L 

#FHSBLN«16,D0 

* 


DO = Number of bytes to clear in high order word 

* 


Fill character in low order byte 


LEA 

TI70200-PBA,A6 


LEA 

0(A2,A6.L),A6 

* 


A6 = Address of routine to execute 


JSR 

(A6) 

* 


Clear the assign parameter block on the stack 


IF <NE> 

THEN.S 


ILLINST 

* 


Execute an illegal instruction 

* 

ENDI 

This should never happen 


MOVE.W 

#FHASGN,FHSCMD(AO) 

* 


Establish the assign command, code 


MOVE.W 

D2,FHS0PT(A0) 

* 


Establish assignment options 


MOVE.B 

D1,FHSLUN(A0) 

* 


Establish the LUN for the terminal device 


MOVE.L 

A1,FHSV0L(A0) 

* 


Establish the terminal device to assign 


TRAP 

#3 

* 


Assign the terminal device to the LUN 


ADD.L 

#FHSBLN,A7 

•k 


Remove assign parameter block from stack 


MOVEM.L 

(A7)+,A0/A6 

•k 


Restore register 


TST.L 

DO 

* 

RTS 

Establish the routine exit conditions 


PAGE 



100 


MICROSYSTEMS 


MOTOROLA 


APPENDIX F 


****************************************************************************** 



INTERNAL 

SUBROUTINE: NSPTASKP 

*** 

*** 



kkk 

*** 

DESCRIPTION: 

kkk 

-k-k* 



kkk 

kkk 

Subroutine to 

kkk 

kkk 


Create task in VERSAdos environment by initiating the 

kkk 

kkk 


following: 

kkk 

kkk 


kkk 

kkk 


Create the Task Control Block (TCB) for task entry 

kkk 

kkk 


Allocate segments associated with task 

kkk 

kkk 


Pass logical units 5 and 6 to task being created 

kkk 

kkk 


Start task if requested 

kkk 

kkk 


*** 

kkk 



kkk 

*** 

NOTES: 


kkk 

kkk 


N/A 

kkk 

kkk 


kkk 

kkk 

REGISTER 

USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 


kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 


kkk 

kkk 

D: 

DRPPPPPPP 

kkk 

kkk 

A: 

P P P P AR AR P P 

kkk 

kkk 



kkk 

kkk 



kkk 

*** 

INPUT: 


kkk 

kkk 



kkk 

*** 


A4 = Address of TASK TABLE entry to be processed 

kkk 

kkk 


A5 = Address of TASK TABLE header 

kkk 

*** 



kkk 

kkk 


LUN 5 MUST be assigned to the TDTI task prior to call 

kkk 

kkk 


LUN 6 MUST be assigned to the TDTI task prior to call 

kkk 

kkk 


kkk 

*** 

OUTPUT: 



*** 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


A4 = Unchanged 

kkk 

kkk 


A5 = Unchanged 

kkk 

kkk 


kkk 

kkk 


DO = See CONDITION CODES below for definition 

kkk 

kkk 



kkk 

kkk 

CONDITION CODES 

kkk 

kkk 



kkk 

kkk 


Not Equal --> Error occurred trying assign LUN 

kkk 

kkk 


kkk 

kkk 


DO = Error code in following format 

kkk 

kkk 


kkk 

kkk 


+ + + 

kkk 

kkk 


1 NSSUPASC INTERNAL | RMS RETURNED CODE | 

kkk 

kkk 


1 ERROR CODE | IF APPLICABLE | 

kkk 

kkk 


1 1 ELSE ZERO 1 

kkk 

kkk 


+ — + - + 

kkk 
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kkk 

*** 


kkk 

k** 

Equal --> LUN assignments were successful 

kkk 

kkk 


kkk 

kkk 

DO = ZERO 

kkk 

kkk 


kkk 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 

kkk 


kkk 

kkk 

Save registers 

kkk 

kkk 

Establish Program Base Address for routine 

kkk 

kkk 

Establish TDTI work area on stack 

kkk 

kkk 

Execute TDTI routine to build TCB 

kkk 

kkk 

IF error 

kkk 

kkk 

Remove TDTI work area from stack 

kkk 

kkk 

Establish error code for TCB build error 

kkk 

kkk 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 

Execute TDTI routine to allocate task segments 

kkk 

kkk 

IF error 

kkk 

kkk 

Remove TDTI work area from stack 

kkk 

kkk 

Establish error code for segment allocation 

kkk 

kkk 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 

Remove TDTI work area from stack 

kkk 

kkk 

Pass logical unit 5 to task being processed 

kkk 

kkk 

IF error 

kkk 

kkk 

Adjust to error exit format 

kkk 

kkk 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 

Pass logical unit 6 to task being processed 

kkk 

kkk 

IF error 

kkk 

kkk 

-Adjust to error exit format 

kkk 

*** 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 

Start the task being processed if start requested 

kkk 

kkk 

IF error 

kkk 

kkk 

Establish error code for trying to start task 

kkk 

kkk 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 

Establish routine exit conditions as successful 

kkk 

kkk 

Save in register DO 

kkk 

kkk 

Restore saved registers 

kkk 

kkk 

Exit routine 

kkk 

kkk 


kkk 


iciciticicieicie’kic'k'k’k'kit'k'k’k'k-k-k-k'kic’k’k'k’k-k’k'k'k’k’k'kig'k-k-k'k’k'k'k'k'k'k’k'kie'k'kicle'kititic'it'kicie-kit'k'k'k'k'k'k'kicicic'kicicit'k 
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PBSIZEPL EQU 

* 

NSPTASKP: 


$5E 


Work area for TDTI task 


MOVEM.L D0-D7/A0-A6,-(A7) 

Save registers 

LEA PBA{PC),A2 

A2 = Program Base Address for this routine 

MOVE.L A7.A6 

A6 = Address where registers were saved 
SUB.L #PBSIZEPL,A7 

Adjust stack for TDTI work space 

MOVE.L A7,A3 

A3 = Address of work area that will be used 
by TDTI routines that are called from 
this routine. 

LEA TI70500-PBA,A1 

LEA 0{A2,A1.L),A1 

JSR (Al) 

Build the TCB for the task being processed 

IF <NE> THEN.S 



ADD.L 

#PBSIZEPL,A7 

* 


Remove TDTI work area from stack 


MOVE.L 

#3«16,(A7) 

* 


DO = NSSUPASC exit error code 

* 


Error creating TCB 


MOVEM.L 

(A7)+,DO-D7/AO-A6 

* 

RTS 

Restore saved registers 

* 

ENDI 

Return to caller 


LEA TI71300-PBA,A1 

LEA 0(A2,A1.L),AI 

JSR (Al) 

Allocate the task segments 

IF <NE> THEN.S 



ADD.L 

#PBSIZEPL,A7 

* 


Remove TDTI work area from stack 


MOVE.L 

#4«16,(A7) 

* 


DO = NSSUPASC exit error code 

* 


Error allocating segments to 


MOVEM.L 

(A7)+,D0-D7/A0-A6 

* 

RTS 

Restore saved registers 

* 

ENDI 

Return to caller 
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ADD.L #PBSIZEPL,A7 

Remove TDTl work area from stack 

CLR.L D1 

Establish change logical unit options 

MOVE.L #5,D2 

D2 = Logical unit to be passed (LUA) 

MOVE.L D2,03 

D3 = Logical unit to be received (LUB) 

BSR.S NSPLCLUN 

Pass logical unit 5 to the task being processed 

IF <NE> THEN.S 

IF D5 <EQ> #0 THEN.S 
MOVE.L #6,D5 

If zero, then error was due to change logical 
unit request; else error occurred trying to 
obtain task identification, and D5 already has 
the internal error code 
D5 = NSSUPASC internal error 

Error trying to pass logical unit 5 

END I 


AJDO 

Adjust register DO to reflect the output format 
for this routine 

MOVE.L D0,(A7) 

DO = NSSUPASC exit error code 

Error trying to obtain task identification 

MOVEM.L (A7)+,D0-D7/A0-A6 

Restore saved registers 
RTS 

Return to caller 

END I 


MOVE.L #6,D2 

D2 = Logical unit to be passed (LUA) 

MOVE.L D2,D3 

D3 = Logical unit to be received (LUB) 

BSR.S NSPLCLUN 

Pass logical unit 6 to the task being processed 
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IF <NE> THEN.S 

IF D5 <EQ> #0 THEN.S 
MOVE.L #7,D5 

If zero, then error was due to change logical 
unit request; else error occurred trying to 
obtain task identification, and D5 already has 
the internal error code 
D5 = NSSUPASC internal error 

Error trying to pass logical unit 6 

ENDI 


■k 


■k 


k 


k 


k 


k 


AJDO 

Adjust register DO to reflect the output format 
for this routine 

MOVE.L 

D0,(A7) 


DO = NSSUPASC exit error code 


Error trying to obtain task identification 

MOVEM.L 

(A7)+,D0-D7/A0-A6 

Restore saved registers 

RTS 

Return to caller 


ENDI 

BSR NSPLSTART 

Start the task if task entry so indicates 

IF <NE> THEN.S 

MOVE.L #8«I6,(A7) 

Establish routine exit conditions as unsuccessful 
Error trying to start task 


* 


* 


* 

* 

* 


MOVEM.L (A7)+,D0-D7/A0-A6 

Restore saved registers 
RTS 

Return to caller 


ENDI 


CLR.L 

(A7) 

MOVEM.L 

(A7) + 

RTS 


PAGE 



Establish routine exit conditions as successful 
D0-D7/A0-A6 

Restore saved registers 
Return to caller 
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****************************************************************************** 


*** 

INTERNAL 

SUBROUTINE: NSPLCLUN 

*** 

*** 



*** 

*** 

DESCRIPTION: 

*** 

*** 



*** 

*** 

Subroutine to 

*** 

*** 


Pass the logical unit to the task being processed 

*** 

*** 


*** 

*** 

NOTES: 


*** 

*** 


The SEND option MUST be used. This routine will 

*** 

*** 


will force this option. 

*** 

*** 


*** 

*** 



*** 

*** 

REGISTER 

USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

*** 

*** 


*** 

*** 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

*** 

*** 


*** 

*** 

D: 

DR AR AR AR P DR P P 

*** 

*** 

A: 

P P AR P AR AR P P 

*** 

*** 



*** 

*** 



*** 

*** 

INPUT: 


*** 

*** 



*** 

*** 


D1 = Options for change logical unit request 

*** 

*** 


SEND option is required 

*** 

*** 


D2 > LUA the existing assignment 

*** 

*** 


03 > LUB the new assignment 

*** 

*** 


A2 = Program Base Address for this routine 

*** 

*** 


A4 = Address of TASK TABLE entry to be processed 

*** 

*** 


A5 = Address of TASK TABLE header 

*** 

*** 



*** 

*** 



*** 

*** 

OUTPUT: 


*** 

*** 



*** 

*** 

REGISTERS/DATA STRUCTURES 

*** 

*** 



*** 

*** 


DO = Trap request status 

*** 

*** 


D1 = Unchanged 

*** 

*** 


D2 = Unchanged 

*** 

*** 


D3 = Unchanged 

*** 

*** 


D5 = Contains NSSUPASC internal code if the task the 

*** 

*** 


being sent the logical unit does not exist, 

*** 

*** 


else the value will be zero 

*** 

*** 


A2 = Unchanged 

*** 

*** 


A4 = Unchanged 

*** 

*** 


A5 = Unchanged 

*** 

*** 



*** 

*** 

C0NDITI0^ 

1 CODES 

*** 

*** 



*** 

*** 


Not Equal --> Error occurred trying assign LUN 

*** 

*** 


*** 

*** 

*** 


Equal --> LUN assignment was successful 

*** 

*** 


****************************************************************************** 
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■k-kie 


kkk 


kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

*** 

*** 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 


Save registers 

Establish work area on stack 

Execute TDTI routine to obtain task identification 
IF error 

Remove work area from stack 

Establish flag - error obtaining task identification 
Establish error exit conditions 
Restore registers 
Return to caller 

Save task identification information 

Execute TDTI routine to zero fill parameter work area on stack 
IF error 

Execute an illegal instruction as this should not happen 
Build the change logical unit (pass) parameter block on stack 
Pass the logical unit to the task being processed 
Remove the TDTI work area from the stack 
Establish flag; error, if one exists, is due to not obtaining 
task ID 

Establish the routine exit conditions 
Return to the caller 


*** 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

*** 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


NSPLCLUN; 

MOVEM.L A0-A3,-(A7) 

* Save registers 

SUB.L #PBSIZEPL,A7 

* Adjust stack for work area required by TDTI 

MOVE.L A7,A3 

* A4 = Address of task table entry being processed 

* A3 = Address of dynamic work area 

* Routine requirement for routines referenced 

* in TDTI 

LEA TI71200-PBA,A1 

LEA 0(A2,A1.L),AI 

JSR (AI) 

* Get task ID as TDTI is a real time task 
IF <NE> THEN.S 



ADD.L 

#PBSIZEPL,A7 


k 


Remove TDTI work area from stack 


MOVE.L 

#5,D5 


k 


D5 = Contains the 

NSSUPASC internal code 

k 


Error trying 

to get task identification 


TST.L 

DO 

k 


Establish routine 

exit conditions 


MOVEM.L 

(A7)+,A0-A3 


k 

RTS 

Restore registers 


k 

END I 

Return to caller 
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MOVE.L 

AI,-(A7) 


MOVE.L 

A0,-(A7) 

■k 


Save respectively session number and task ID 

k 


on stack 


MOVE.L 

A3, AO 


MOVE.L 

#FHSCLN«I6,D0 

k 


AO = Start address of parameter block 

k 


DO = Routine input identifying number of bytes 

k 


to fill and the fill character 

k 


Routine requirements for TI70200 


LEA 

TI70200-PBA,A1 


LEA 

0(A2,A1.L),A1 


JSR 

(''I) . 

k 


Zero fill the change LU parameter block 


IF <NE> 

THEN.S 


ILLINST 

k 


Execute an illegal instruction 

k 

ENDI 

This should never happen 


MOVE.W 

#FHCHLU,(A0) 

k 


Establish code, command 


MOVE.W 

D1,FHS0PT(A0) 


AND.M 

#$FFFE,FHSOPT(AO) 

k 


Establish user’s specified options 

k 


Force the SEND option 


MOVE.L 

(A7)+,FHSTSK(A0) 


MOVE.L 

(A7)+,FHSSES(A0) 

k 


Establish the task name/session number in pb 


MOVE.B 

D2,FHSLUA(A0) 


MOVE.B 

D3,FHSLUB(A0) 

k 


Establish LUA and LUB for the parameter block 


TRAP 

#3 

k 


Pass the LU to the new task 


ADD.L 

#PBSIZEPL,A7 

k 


Remove TDTI work area from stack 


CLR.L 

D5 

k 


Establish flag -- Error, if one exists, is due 

k 


to not obtaining task identification 


TST.L 

DO 

k 


Establish routine exit conditions 


MOVEM.L 

(A7)+,A0-A3 

k 

RTS 

Restore registers 

k 


Return to caller 
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****************************************************************************** 


icicic 

INTERNAL 

SUBROUTINE: NSPLSTART 

kkk 

•kicic 



kkk 

kk-k 

DESCRIPTION; 

kkk 

kkk 



kkk 

kkk 

Subroutine to 

kkk 

kkk 


Start task if requested 

kkk 

kkk 


kkk 

kkk 

NOTES: 


kkk 

kkk 


N/A 

kkk 

kkk 


kkk 

kkk 

REGISTER USAGE (A)rgument (D)estroyed (P)reserved (R)eturned 

kkk 

kkk 



kkk 

kkk 


0 1 2 3 4 5 6 7 SR hi SR lo (CCR) 

kkk 

kkk 


kkk 

kkk 

D: 

PPPPPPPP 

kkk 

kkk 

A: 

P P AR P AR AR AR P 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

INPUT: 


kkk 

kkk 



kkk 

kkk 



kkk 

kkk 


A2 = Program Base Address for this routine 

kkk 

kkk 


A4 = Address of TASK TABLE entry to be processed 

kkk 

kkk 


A5 - Address of TASK TABLE header 

kkk 

kkk 


A6 = Address where registers D0-D7/A0-A6 are saved 

kkk 

kkk 


kkk 

kkk 



kkk 

kkk 



*** 

kkk 

OUTPUT: 


kkk 

kkk 



kkk 

kkk 

REGISTERS/DATA STRUCTURES 

kkk 

kkk 



kkk 

kkk 


A2 = Unchanged 

kkk 

kkk 


A4 ° Unchanged 

kkk 

kkk 


A5 - Unchanged 

kkk 

kkk 


A6 = Unchanged 

kkk 

kkk 



kkk 

kkk 



kkk 

kkk 

CONDITION 

CODES 

kkk 

kkk 



kkk 

kkk 


Not Equal --> Error occurred trying to start task 

kkk 

kkk 


kkk 

kkk 


Equal --> Task started successfully 

kkk 

kkk 


or did not request starting 

kkk 

kkk 



kkk 


****************************************************************************** 
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*** 

*** 

■k*ic 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

■k** 

•kick 

kkk 

kkk 


Save registers 

If task state is dormant 

Restore saved registers 
Exit task 

Establish TDTI work area on stack 
Start the requested task 
Remove work area from stack 
IF error 

Establish error exit conditions 
Restore saved registers 
Return to caller 

Establish successful exit conditions 
Restore saved registers 
Return to caller 


kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 

kkk 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


NSPLSTART: 


MOVEM.L A1-A3,-(A7) 

Save registers 


IF.B #’D’ <NE> TTSINITS+KA4) THEN.S 

LEA 

TI72800-PBA.A1 

LEA 

0(AI,A2.L),A1 

* 

A1 = Address of routine to execute 

MOVE.L 

A6,-(A7) 

MOVE.L 

A7,A2 

* 

A2 = Contains address where initial 

* 

are saved on the stack 

SUB.L 

#PBSIZEPL,A7 

* 

Adjust stack for TDTI work area 

MOVE.L 

A7.A3 

■k 

A3 = Requirement for T I 72800 

JSR 

(AI) 

* 

Start the requested task 

LEA 

PBA(PC),A2 

* 

Restore register A2 

ADD.L 

#PBSIZEPL,A7 

* 

Remove TDTI work area from stack 

MOVEM.L 

(A7)+,A6 

* 

Restore Register A6 

IF <NE> 

THEN.S 



CMP.L 

A7,A3 

* 


Establish error exit conditions 


MOVEM.L 

(A7)+,A1-A3 

* 

RTS 

Restore save registers 

* 

END I 

Return to caller 
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* 

* 

* 


* 

* 


CMP.L 

MOVEM.L 

RTS 

ELSE.S 

MOVEM.L 

RTS 

ENDI 


DO, DO 

Establish good exit conditions 
(A7)+,A1-A3 

Restore save registers 
Return to caller 


(A7)+,A1-A3 

Restore save registers 
Return to caller 


PAGE 

NOP 

PRGMSIZE EQU *-NSSUPASC 
END 
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INDEX 


absolute address 
ACIA 

address segment number(s) (ASN) 

allocate sectors 

ASN 

assembler 
assembly language 

base address 
boldface strings 

cache memory 
CCR 

chainfile(s) 

character fill 
command file 
command line 
condition codes 

conventions 
COPYSGEN 
CRTCB directive 

data structure 
DCLSHR directive 
debug 

demonstration system 

driver(s) 

dummy task 

editor 

EHL 

EIV 

error handling logic (EHL) 


Error Index Value (EIV) 
external references 

File Handling Services (FHS) 
FHS 

file management subsystem 
File Management System (FMS) 
flag(s) 

FMS 

free memory lists 


8, 20 
35 , 47 
3 
71 

See address segment number 
20 , 24 , 36 , 37 , 62 , 64 

17 , 21 , 25 , 77 

30 , 95 , 96 , 99 , 102 , 103 , 106 , 109 
5 

30 

67 - 72 , 96 , 99 , 101 , 106 , 109 

1 , 29 , 31 - 36 , 50 , 52 , 55 , 56 , 

58 - 63 , 90 

30 , 67 , 93 

48 , 50 , 51 , 52 , 54 , 60 , 85-89 

17 , 31 , 32 , 58 , 77 , 78 , 95 

67 - 71 , 73 , 97 , 99 , 101 , 106 , 

109 

5 

35 , 60 , 61 

14 

8 

15 

2 , 3 , 10 
79 

1 , 2 , 6 , 29 , 32 , 33 , 35 , 47 , 58 , 79 
23 

17 , 23 

See error handling logic 

See Error Index Value 

1 , 6 , 9 - 12 , 20 , 29 , 30 , 33 , 34 , 36 , 

37 , 39 , 45 , 48 - 50 , 63 - 65 , 68 , 69 , 

71 , 72 , 75 , 79 - 81 , 85 , 86 , 90 

10 , 75 , 76 

30 , 36 , 82 , 85 , 93 

1 , 6 , 32 , 47 , 56 , 60 , 61 , 79 
See File Handling Services 
2 

32 , 56 , 57 , 61 

40 , 41 , 48 , 49 , 86 , 107 , 108 
See File Management System 
3 


113 


MICROSYSTEMS 


(g) MOTOROLA 


INDEX 


get task ID 

global segment table (GST) 

GO command 

GST 

GTSEG 

hierarchical relationships 
high level languages 

I/O subsystem 
I/O vector map (lOV) 
include file 

Initial Program Loader (IPL) 

initialization 

initial izer 

Input/Output Services (lOS) 

Intelligent Peripheral Controller (IPC) 

invoking TDTIGENl 

invoking TTGEN 

lOS 

lOV 

IPC 

IPL 

italic strings 
JSR instruction 


kernel 

LIB 

link file(s) 
linkage editor, linker 
1 ink(s) 

load module(s) 
loader 

Loader Information Block (LIB) 
logical address 

logical unit [number] (LU, LUN) 
LU, LUN 

M68000-family 

Memory Management Unit (MMU) 

memory map 

menu(s) 

MMU 

monitor task 
MVMEllO 
MVME120 
MVME121 


30, 70, 107 
3 

3, 34 

See global segment table 
15 

6 

77 

1, 2, 4, 29, 79 
3 

36, 50-52, 54 
3 

3, 4, 72, 73, 77, 78 
1 3 4 29 

l! e! 32, 47, 56, 60, 61, 79 

79 

31 

17 

See Input/Output Services 
See I/O vector map 
See Intelligent Peripheral 
Controller 

See Initial Program Loader 
5 

12, 40, 72, 68, 71, 72, 75, 100, 
103, 107, 108, 110 

1 , 4 

See Loader Information Block 
50, 51, 52, 81, 82, 89 
22, 36, 45, 82, 90 

4, 7, 8, 30 

17, 19, 21, 22, 24, 25, 35, 82, 85 

2, 56, 57 
17, 22, 82 
15 42 43 

7l’, 78| 92, 95-102, 104-107 
See logical unit 

1 

3, 29, 30 
79-81 
17-25 

See Memory Management Unit 

9, 14, 26, 27, 41, 83, 84 

33-36 

30 

30 
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INDEX 


non-standard code 


offset 

option(s) 


partition(s) 

Pascal runtime initializer 
Pascal task(s) 

PAT 

PC 

periodic activation table (PAT) 

physical address 

pointer(s) 

priority 

Program Counter (PC) 


RAM 

register(s) 

related documentation 
RMS 

RMS68K 

ROM 

RTS instruction 


runtime library 

segment attributes 
self-relative offset 
Session Control 
session manager 
session number 
shareable segment 
shared access 
SHRSEG directive 
stack pointer 

stack register 
standard processing 
start task 
starting address 


1 , 2 , 4 , 6 , 9 , 12 , 13 , 23 , 26 , 27 , 
29 , 30 , 33 , 34 , 36 , 37 , 40 , 45 , 46 , 
48 , 51 , 61 , 63 , 64 , 77 - 85 , 87-92 

7 - 13 , 20 , 23 , 25 - 27 , 39 , 40 , 69 , 
82-84 

9 , 10 , 14 - 17 , 19 , 22 - 27 , 41 - 44 , 62 , 
63 , 84 , 97 - 100 , 104 , 106 , 108 

29 , 30 , 32 , 35 , 45 , 46 , 59 , 79-81 
77 

77-111 

See periodic activation table 
See Program Counter 
3 

8 , 15 , 16 , 23 , 30 , 42-44 

8 , 11 , 12 , 23 , 30 , 39 , 40 , 68 , 69 , 

71 , 72 

4 , 9 , 11 , 13 , 14 , 21 , 23 , 26 , 27 , 
42 , 45 , 82-84 

2 , 3 , 47 , 50 - 52 , 86 - 88 , 95 , 103 , 

110 

2 , 3 , 6 , 8 , 16 , 29 , 32 , 34 , 35 , 44 , 
61 , 79 , 80 

3 , 10 - 12 , 34 , 36 , 39 , 40 , 67 - 73 , 

77 , 78 , 92 , 95 , 96 , 98-111 

5 

31 , 47 , 55 , 56 , 58 , 59 , 79 , 81 , 92 , 
94 , 97 , 101 

1 - 4 , 6 , 13 - 15 , 29 , 31 , 32 , 36 , 42 , 
43 

2 , 3 , 29 , 30 , 32 , 35 , 46 , 57 , 79 - 
82 , 85 

11 , 12 , 39 , 40 , 53 , 72 , 78 , 95 , 96 , 
98 , 100 , 103 - 105 , 107 , 108 , 110 , 

111 

79-81 


. 10 , 

15 , 

16 , 26 , 

27 , 

, 42 

, 43 , 82 - 

-84 

7 , 

9-13 

, 39 , 40 
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56 , 

57 , 95 





77 







9 , 

14 , 

26 , 27 , 

41 , 

82 - 

84 , 108 


15 , 

16 , 

42 , 43 , 

76 




15 







15 







11 , 

12 , 

39 , 40 , 

68 - 

■ 72 , 

75 , 99 , 

100 , 

102 

-104 

, 107 , 108 , 

110 



3 , 

34 







2 , 4 , 12 , 36 , 53 , 77 

72 , 73 , 91 , 93 , 101 , 102 , 105 , 109 

21 , 24 , 25 , 47 , 54 , 100 
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INDEX 


SYSGEN utility 
SYSPAR 

system generation 

system initializer 

System Parameter Area (SYSPAR) 

Task Control Block (TCB) 

task entry 


task ID 

task initial state 
Task Table (TT) 


task table entry (TTE) 

task table generator 

task table header 

task table structure (TTS) 

TCB 

TDTIGENl utility 

timers 

TRAP(s) 

TT 

TTE 

TTGEN utility 
TTS 

UDR 

user semaphore table (UST) 
user-defined directive table (UDR) 
UST 

vectors 

VERSAdos 

VM04 

VM22 

VMEsystems 


2, 3, 31-37, 48-52, 54-61, 63-65, 
85, 89, 93 

See System Parameter Area 
3 

1, 3, 4, 6, 29 
3 

2, 4, 7-9, 12, 14, 26, 27, 30, 41, 
47, 68, 83, 84, 92, 93, 101-103 

4, 7, 9-11, 14, 18, 21-27, 36, 39, 
40, 42, 51, 77, 83, 84, 89, 101, 

105 

14, 23, 26, 27, 30, 83, 84, 107, 

108 

2, 9, 16, 21, 22 

1, 4, 6-13, 17-25, 29, 30, 32, 33- 
37, 39-41, 45, 46, 48, 50, 52, 54, 
57, 60, 63, 75, 76, 78-82, 85, 86, 
88-90 

6-13, 15, 19, 39-41, 53, 68-73, 

82, 92, 96, 101, 106, 107, 109 
17, 82 

9, 18-20, 39, 92, 96, 101, 106, 109 

13, 34, 39-41, 45, 49, 52-54, 64, 

65, 68, 69, 71-73, 75 

See Task Control Block 

31, 33, 34, 55 

3 

4, 15, 53, 70, 79, 100, 108 
See task table 
See task table entry 
7, 17-19, 21-25, 79, 82 
See task table structure 

See user-defined directive table 

3 

3 

See user semaphore table 
3 

1, 2, 4, 17, 23, 24, 29, 31, 32-34, 
54-59, 61, 77, 80, 85, 91, 96, 101 
55, 79 
79 
30 
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